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PREFACE 


This nanual ts intended for the person who is charged with 
configuring the GC)S 4 MOD 400 system software to meet the 
characteristics and requirements of his installation stte. This 
person is assumed to he well acquainted with the GCOS 6 MOD 400 
executive and with CII HONZYWELL Bull’s Sertes 40 (Mini 4) 
miniconputer systems, [nm addition, this person is assumed to have 
read tne Systen Concepts manual, and if he intends to build 4 systen 
sunporting communications devices, the Communications Processing 
Manual. The Yanual Directory at the »eqinning Of this manual lists 
the titles and orders numbers of rertinent documents. 


This publication describes tn detail the srocedures necessary to 
build the system, the system building directives from which the 

MOD 410 Zxecutive {s assembled, and the utility programs used {n the 
building process. 


Section [ of this manual introduces the surjeet of system buf ldiag 
and oriefly deserthes the conterts of the Jocument, 


Section If outlines information the system hutlder mist jather prior 
to configuriag a system to his specifications. 


Section II! describes the triree stages of syste: startup and the 
purpose of each stage. Section I[I also descrihas the oreratrar’s and 
tne system’s actions during system startuos. 


Section IV dascribes how to tise the (nteractive CLM directive 
generation projram, “44_SYSDSF. 


The information and soecifications in this document are subject to 
change without notice. This document contains faformatisn about 

CII AQNEYWELL BULL prodtets or services that may not be avallable in 
all countries. Consult your CII HONEYAELT PULL Marketing 
Reoresentative. 


Section V describes in detall the noncommunications directives that 
are processed hy the Confiauration Load Manager -=- 2 system software 
tool -- as it configures the system to stipulated specifications. 


Section VI describes conmunications-related directives processed by 
the Configuration Load Manager. ae ’ 


Section vII lists the contents of the system disks on which GCIS 6 
MOD 4990 and other related software coapo.ents are available, 
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Section VIIL tneludes a number of miscellaneous but important 
technical notes, most of which oertain only to certatn installation 
sites. This section should be read before attempting to use the ~ 
systen. 


Anpendix A presents an overview of the various types of halts 
Sossiole duriny system startup. 


Appendix 8 lists the names and approximate sizes of all system 
overlays, which nay be used as overlays or, where optimum speed is 
desired for the related function, selectively tlade permanently 
resident in memory. 


Anpendix C contains minimum system guidelines and a list of 
supported equipment. 


Appendix D deseribes configuration considerations relative to the 
Power Resumption Facility. 


Aopenidix E deals with configuration information (ineluding linking) 
pertaining to the Data Entry Facility. _) 
Appendix F describes configuration tnformation for the Remote Batch 
racility. 


Appendix G presents configuration information relative to the ftle 
transmission capability. 


Aopendix H and Appendix J provide configuration tnformation 
pertaluing to 134 Norkstation Facilittes. 


Appendix K oresents configuration tnfornation for the Programmable 
racility/3271. 


Appendix L deseribes Installation and activation of the Listener and 
Login capability. 


Anoenalx M orovides a handy checklist for use with the M4_SYSDEF 
interactive CLY¥ directive generation orojram. > 


Anoeniix N provides configuration tnformation for the error logging 
caparility. 


Appenifx P provides configuration information for the Display 
rornatting and Control software. 


Appendix R provides configuration information for the Asynchronous 
wharacter Terminal Driver, 


After readinj this manual, the user should be able to duild, the 
systea for initial operation and onsite oersonnel training, and 
rebullji the system later on, if necessary, to satisfy the 
installation’s changing needs. 


The axamoles presented in this publication are for illustrative 
purposes Only# they not intended for execution, 
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For the sake or clarify in examples, user typeins (commands and 
\ directives) are distinguished from system tyneouts (responses) by 
arrows, as shown? 


=> COMMAND LINE 
SYSTEY RESPONSE 


The followin3z conventions are used to indicate the relative levels 
Of topic headings used in this manual: 


Level 1 (highest) A‘ CAPITALS, UNDERLINED 

Level 2 Enitial Capitals. Underlined 
Level 3 A'L CAPITALS, NUT UNDERLINED 
Level 4 Initial Canitals, Not Jnder lined 


(- Symbols used in this manual are described helowt 
- Brackets (] indicate an ootional directive entry. 


- Braces { } enclose information fron which 3 choice must he 
nade, 


» Tre character 4 indicates a space, 
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SECTION I 
SYSTEM BUILDING OVERVIEW 


Systen butiding consists of several discrete overations, each 
described itn different sections of this manual. The purpose of this 
section is to place these overations into perspective, and to enable 
you to obtain a general view of the system building process. 


CII HONEYWELL BULL delivers a disk volume containing tha software 
you orderei olus an ooerating MOD 400 Executive. System building 
consists of specifying your system variables, identifying your 
pertpneral devices and (optional) communications environment and 
tailoring main memory to suit system and user needs. A “system 
bulla." starting with the initially suxolfed system, consists of the 
operations described below, 


PRELIMINARY CONSIDERATIONS 


S3efore starting to build your system, you must take stock of the 
hardware in your configuration. You must be familtar with the 
characteristics of each peripheral and (optional) communications 
device. You must also be aware of what software oackages you wish to 
bufli into your system, consulting the appropriate software manuals 
as necessary. These preliminary considerations are Jiscussed in more 
detati in Section II. : 


[INITIAL SYSTEM STARTUP 


System huilding is a progressive process and is typically performed 
ir. tnree discrete stajges, each of which ts initiated by an 
aporooriate tyoe of system startup. To Suild your new MOD 400 
system, you must first start uo the tnitially supplied system on 
your hardware configtiration. The system is desizned to start uo 
without daifficulties on most hardware configurations. 


The three stages of system startup, and the ournose of each stage, 
are jJascribej in Section III. Each stage of system startup involves 
('}) Hantstraoping the system from disk into, main memory, (2) 
execution of the Configuration Load Manager (CLM) which reads a file 
of CLM directives and causes the system to be configured 
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accordingly, and (3) creation of a systen task grouo. As described 

in Seetion III, additional actions are possible at system startup, 
depending on whether a spectal file (named START_UP.EC) exists in — 
the inittal working directory of the system task group. 


SYSTEW BJILDING 


System building consists of creating a file containing 4 series of 
systen building directives which comoletely specify the 
characteristics of the system. These characteristics include the 
hardware options and physical memory oresent in the central 
processor, the complement of perinoheral and communications devices 
4resent in your configuration, and the manner in which memory ts to 
be allocated among system and application tasks. (The system 
ouilding dtrectives are described in detail in Sections V and VI). 


You create this directive file on disk, using either an interactive 
huLliing program or the standard text editor. Once created, the file 3) 
contains configuration directives, which when executed, will 

configure a system that corresponds to the actual installation 

hardware, 


HOW TO USE THIS MANUAL 


Sections I, !f and I!f should be read carefully before you begin 
systen building procedures. Sections I and I! provide a general 
descrintion of systen buf{lding and outline the {anformation a 
first=tine user needs to know before building a spectalized system, 
Section III deseribes the three stages of system startuo that must 
oe followed to create an ooserating environment, 


An interactive CLM directive generation program, called M4_SYSDEF, 
is provided for your convenience in creating the CLM directive file, 
anj is fully described in Section IV. Using M4_SYSDEF according to ») 


directions will result {n a syntactically correct file of CLM 
directives. 


Yon-conmuntcations CLM directives and communications CLM directives, 
used to specify the system configuration, are described in detail in 
Section V and VI, respectively. Refer to these sections when 
creating or modifying your specialized CLM directive file. If your 
system supports communications devices, you should be familfar with 


the Communications Processing manual. 


Section VII deserihbes the contents of the system release media, 
Typically, an installation will receive all of its system software 
(including any separately oriced “extensions” that have been 
ordered) on one tyne of release mediums that is, On One or two 
cartridge disks, on one mass storage unit (also called a “storage 
module"), On One cartridge module disk, or on multiole diskettes. 
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Section vili comorises a number of miscellaneous technical notes, 
most of which pertain only to certain tnstallation sites. It is 
{important that each prospective system builder familtarize himself 
with the contents of Section VIII and ascertain which of its topics 
apply to his installation, before he attempts to use the system, 


Most of the 3npendixes in this nanual also describe subjects of 
Interest only to certetin installation sites. Amonjz these subjects 
are configuration information regarding the Data Entry Facility-I 
(DEr-I), the Remote Batch cacility (Hor), and file transmission. 


Anpendixes 4, J, and K present configuration tnformation for the IBY 
VJorkstation racilities and the Progranmable racility/327!. Appendix 
L deserides Listener and Login capabilities. 


An M4_SYsDer checklist is supplied for your convenience in Appendix 
M. Jse this list as 3 juide when defining your system’s resources 
prior to invoking the “4 _SYSDEF program, 


Appendix N describes how to configure the error loqging capability 
so your installation can monitor memory and device performance. 


Appendix P describes configuration procedures for the Display 
rornatting and Control software. This software provides the forms 
processing capability for your installation. 


In jeanerail, this manual does not i{nelude conceptual information?’ 
ingteai, where necessary, see the Systen Conceots manual and/or a 
nanual ssxecific to the desired subject area. Commands mentioned tn 
this nanual are descrihed Ln the Commands manuai. Those operator 
commands that are not avaflable to the general user community, for 
exanole the CSD) (change system directory) ooerator command, are 
Jesceribed in the Operator’s Guide. Systen nacro calis are described 


in the Systen Service Macro Calls manual, 
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SECTION II 
PRELIMINARY CONSIDERATIONS 


3Jefors you actually begin to build your system, you should first 
compile the information you’11 need to configure the system to your 
svecifications. The categories of information required are broken 
into hardware, software, and conmunications considerations and are 
jJiscussei further below, Figure 2-1 {ts a flowchart of the 
reconnended srocedure for gathering information. 
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Figure 2-!. Preliminary Considerations Flowchart 
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HARDANARE CHARACTERISTICS 


You must have available the hardware characteristics of the devices 
in your configuration. You can obtain this information by consulting 
the appropriate hardware reference manuals as necessary. 


Specifically, for the central processor, you must know? 
« The model number 
« Whether the central processor is a commercial model 


- Whether the central processor includes the Seienti fic 
Instruction Processor 


- The size of main memory 


« The number of multtole/dual~line communications processors 
(ULOPS/ILCPs) 


Por peripheral devices, you must know? 


e The maximum number of devices that you want to configure 
(regardless Of how many are on the bus) 


« dow many of each type of oeripheral device you have in your 
configuration, tdentified by marketing identifier (see Anoendix 


c) 


- ror terminals, you must know the transnission modes, line 
sneeds, desired [7/0 characteristics, and modem types 


- For disk Jevices, you must know whether each cartridge disk or 
cartridge module jisk has a fixed and removable plattert you 
must als@ know the storage capacity of each device 


- For tape drives, you must know the recording density and number 
Of tracks. 


SOFTNARE CHARACTERISTICS 


Ince you have compiled a list of hardware characteristics, you 

should proceed to jather information on the software characteristics. —... 
of your configuration. You must determine what software subsystems 

your installation will use. Equipment requirements and 

characteristics of individual software packages are available in the- 
appropriate software reference manuals. 


Spectfically, you must know: 


- The text strings you wish to use as the system and installation 
{dentification of your system 
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The anticipated maximum number of concurrent users 


The largest logicat file number and logical resource number 
available to users 


The anticipated number of S!2=<word system overlay areas 


Ahether or not the system will include a batch memory pool (and 


its size) 


Ahether the system will include the commercial or scientific 
instruction stmulators 


Ahether Or not the system will incorporate record locking or 
Display Formatting and Control software 


A coherent assignment scheme for symbolic oeripheral device 
names, channel numbers, communtcations priority levels, and 
logical resource numbers (see tne System Concents nanual) 


The number of comaunications line protocols (the recommended 
maximum is two per MLCP/DLCP),. 


COMMUNICATIONS CHARACTERISTICS 


If you intend to {nclude communications devices in your 
configuration, you must read the Communications Processing manual 
first, and be thoroughly familiar with the hardware and software 
characteristics of your communications devices. 


Specifically, you must knows 


J 


dhich protocols you need 

For polled Vie devices (VIP7700 or VIP7804), a voll address 
scheme, device type, which stations are control/tributary 
stations, and characteristics of any receive-only printers 


For H3270 Host Links, a poll address scheme, a select address 
scheme, and a communications priority level for each line 


A priority Level starting scheme 


The number of channel control programs oer MLCP/DLCP (the 
recommended maximum is two) 


For asynchronous terminals, the communications priority Level 
and device type for each 


For BSC lines, the communications oriority level and the number 


of prinary and/or secondary Lines 
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ror ACU cnannels, the Irn of the station associated with each 
ACU and the list of telephone numbers associated with each data 
communications channel 


For stations driven by a userewritten line protocol handler, 
whether the line ts full— or hnalfeduslex, and the Iph-specific 
word for each station 


ror teleprinter compatible devices, the communications oriority 
level and modem type for each device 


Ahich communtcations stations will be accessible through the 
file system 


The politng scheme on a line serviced by the synchronous 
terminal driver line »rotocol handler 


For polled or nonpolled VI? terminals, the Irn, level, and 
channel 


ror IBM workstations on a line serviced by the HASP line 
orotocol handler, the Irn, level, and channel 


ror stations on a line serviced by the Remote Computer 
Interface line protocol handler, the Irn, level, and channel. 


is only meant to be a representative sampling of some of the 


software and hardware characteristics of which you must be aware. 
ror a full deseription of each communications protocol, see Section 


VI. 
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SECTION III 
SYSTEM STARTUP 


System startup consists of the following steost 


1. Tne system 1s bootstrapped into main Memory as the result of a 
procedure performed at the central processor’s control panel. 


2. The Configuration Load Manager (CLM), a system component, 
reads a file of CLM directives, which causes the system to be 
configured according to the contents of the directives. 


3. A system task group ($5) is created after system configuration 
is completed. [If the [nittal working directory for the system 
task grouo contains a file named START_UP.EC, the operator 
commands in that file are executed to further establish the 
environment that is desired at the end of system startup. (For 
example, the START_UP.EC file may contain Operator commands 
that spawn additional task groups.) 


Thus, systen startup establishes an operating environment and brings 
the system to a “ready” state, at which point system operations may 
begin. 


There are three stages of system startup. 


I]. Stage } Initial System Startup. which is performed at system 
Installation. (1) This type of startup is used to establish a 
Linited environment that will allow you to use the interactive 
CLM directive generation progran M4_SYSDEF or the Editor to 
create your own file of CLM directives. During a stage |! 
system startup, the Canfiguration Load Manager reads one of 
two supplied files of CLM directives that define a limited 
environment. The file of CLM directives read by the 
Configuration Load Manager depends on which of the following 
situations exist at system startup: 


a. Bootstrap volume is a cartridge disk, cartridge module 
disk, diskette, or mass storage unit one or more terminals 
are cOnnected to an MDC. 


C1) 

A staje |! systen startup can also be used at a later time, in the 
event that an error in a user-created file of CLM directives 
orevants a successful stage 2 or stajye 3 system startup. See 
"S5otstrao Jotions* later in this section. 
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®. bootstrap volume is a cartridge disk, cartridge module 
disk, diskette, or mass storage units no terminal is 
connected to an MDC, but one or Tore terminals are sf 
connected to an MLCP/DLCP. 


In @ stage | system startup, the tnitial working directory for 
the system task group is SID. This working directory contains 

a START_UP.EC file that causes a second task group ($5) to be 

spawned. (!} 


2. Stage 2 Intermediate System Startup. This stage of system 
startup is used after you have created your own file of CLM 


directives, 1.6., a file named CLM_USER (under SID), which 
describes your own installed hardware configuration and other 
details of the environment you wish to use for application 
develooment. (You will have created CLA_JUSER by using 
M4_SYSDEF or the Editor itn the limited environment established 
as the result of a stage i system startup.) 


In a staze 2 system startup, your tailored CLM_USER file must 
exist under directory SID on the bootstrap volume. The * 
Configuration Load Manager will read this file instead of the — ’ 
one selected during a stage ! system startup. 


In a stage 2 system startus, the initial working directory for 
the system task group is the root directory of the hootstrao 
disk. This working directory contains a START_UP.EC file that 
causes 4 second task grouo (SH) to be spawned. 


Following a stage 2 system startuo, sanolication development 

can oroceed in an environment you have defined to natch your 

own resources and needs. Ahen you have reached a point where 

you wish to define a fully smecialized system refined tr 
orecisely match your reauirements for a standard overatiny 
environment, you can use the M4_SYSOEF program in Rebuild mode 
or the Editor to modify the contents of CLM_USER so that they 
deserive your final system. In addition, you can nodify (or 
delete) the START_UP.EC file of operator conmands immediately 
subordinate to the root directory of the bootstrap volute. 

Note that “refining” takes place over a period of time, as you >) 
gain experience with the system. - 


3. Stage 3 Fully Soecialized System Startup. This stage of systen 
startup Is used after you have nade nal adjustments to the 
CLM directives in the CLY_USER file and any necessary 
modifications to the STARTLUP.cC file. This stage of system 
startup is used to achieve your final configuration, one that 
reflects your total hardware environment, optimized use of 
central orocessor main memory, and all other characteristics 
of your standard system, 


(1) 


>SID>START_UP.EC is reserved for use during a stage | system 
startup. 
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Ince a satisfactory CLM_USER file and START_UP.EC file (if 


any) have been established, 


this tyoe of system startup can be 


serformed routinely, even by noncomputer personnel. 


STAGE | INITIAL SYSTOM STARTUP 
ONS OF TNO CII 4ONSYWEL'. BULL 


SYU?PLIED FILES OF CLM DIRECTIVES 


[3 JSEDTO DEFINE A LIMITED 
SNVIRONMENT IM AHICH M4_SYSDEF 
Ue THE EDITOR CAN BE RUN TO 
CREATES AN INSTALLATION@S°ECIFIC 
PILS OR CLM DIRECTIVES. 
(>SID>START_UP.EC PILE [S EXE- 
CJTED FOLLOWING CONFIGURATION, ) 


STASE 2 INTERMEDIATE SYSTEM 
STAP TUP 


USZR-CREATED FILE OF CL' 
JIRSECTIVES, CLM USER, IS USED 
T.) DEFINE AN ENVIRONMENT IN 
AHiCd APPLICATION DEVELOOMENT 
CAN BE PERPURYED. (*R90T 
JIRECTORY>START UP.EC FILE IS 
EXZCSUTED FOLLOWING 

CINE IGURATIUN. ) 


STAJE 3 FULLY SPECIALIZED 
SYSTEW STARTUP 


PJELY SPECIALIZED FILE Or CL¥ 
JPRSCTIVES CADJUSTEW CL USER) 
Is JS=EL T) DEFINE THE STANDAQD 
ENVIRONYWENT frOR FULL SYSTEM 
OPZRATIONS. (CIF PRESENT, 

“2 OT DIRECTORY>START_UP.EC 
rPILS IS EXSCUTED FOLLOWING 
CINE TSURATION, ) 


rigure 3-1! summarizes the three stages of system startup. at 


AYEN PERFORMED 


ONCE AT SYSTEM INSTALLATION, 
THEREAFTER, IF NECESSARY, TO 
PERWIT CORRECTION OF ERRORS IN 
USER-CREATED FILE OF CLM 
DIRECTIVES. 


AHEN PCRFORMED 


ONCS AT SYSTEM INSTALLATION, 
APTER CREATION OF CLM_JSER 
FOLLOWING A STAGE | SYSTEM 
STARTUP. Ene n en AS 
NECESSARY. 


WHEN STANDARD SYSTEM OPERA= 
TIONS ARE FEASIBLE, AFTER 
NECESSARY APPLICATIONS HAVE 
BEEN CREATED FOLLOWING A 

STASE 2 SYSTEM STARTUP. A 
STASE 3 SYSTEM STARUP CAN BE 
PESFORMED ROUTINELY AFTER 
SATISFACTORY CLM USER AAS BEEN 
ESTABLISHED, 


Figure 3-1. Stages of System Startup 
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STAVE | SYSTEM STARTUP CINITIAL SYSTEM STARTUP) 


A stage | system startup causes the system to be bootstrapped, the 
Configuration Load Manager to configure the system using an existing 
the of CLM directives, and the operator commands tin the 
>SID>START_UP.EC file to be executed. The result is a limited systen 
environment that allows you to use the interactive CLM directive 
generation program M4_SYSDEr or the Editor to create your own file 
of CLM directives. 


The anvironment achieved by a stage | system startuo is as follows? 
. A removable cartridge disk, cartridge module disk, a mass 
storage unit, or a distette (depending On the device from which 
the system was bootstrapped),. 


e Zither an MDC-connected operator termial or an MLCP.DLCP 
connected oserator teratinal. (The former is used, if present). 


« Une online memory vool and one online task group ($H), in 
addition to the system memory pool and system task group ($5). 


A staje | system startup consists of the following steost 


i, Set the central orocessor control panel POWER switch to ON and 
turn On the power for all devices. 


2. Yount the volume containing the CII HONEYWELL B8ULL=sunolied 
system software on the bootstrap device (cartridge disk, 
cartridge module disk, mass storage unit, or diskette). 


3. Perform the following bootstrap orocedure at the central 
processor control pannel? 


a. Press Stop. 

db. Press Clea. 

c. Press Load. 

jd. Press Execute. 

@. Wait for the TRAFFIC light to turn off. (If the bootstrap 
channel is not 04C0O and/or if any of the bootstrap. options 
described in Table 3-2 are to be used, see “Onerator’s 
Startup Actions,” later in this section). 

f. Press Ready. 

J. Press Execute. 

_ The system {ts dDootstraoped into main memory. Depending on 
the terminal configuration, one of the two sucolied files 
of CLM directives under directory SID is read by the 


Configuration Load Manager and the system {¢ configured 
accordingly. 
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(iy Cualwoc is used if the bootstrao volume its a cartridge 
disk, cartridge module disk, mass storage unit, or 
diskettes one or more terminals sere connected to an 
MLCP/DLCP. 


(2) CLM_MCP is used if the bootstrap volume ts a cartridge 
disk, cartridge module disk, mass storage unit, or 
diskettet one or more terminals are connected to an 
MLCP/OLCP, 


If your configuration includes both MDC=- and MLCP/DLCP 
connected terminals, the system uses CLM_MDC. 


A system task group ($5) is spawned. The operator commands 
in >SID>STARTL_UP.=C are executed, and a user task group 
($H) {is snawned, 


If your configuration tncludes a terminal connected to an 
MDC, system startup is now complete. Otherwise, your 
configuration must include a terminal connected to an 
MLCP/DLCP and you must perform steps h, tf, and j (full 
control panel required). 


nh. Wait for the TRAFFIC light to turn off. (If the terninal’s 
line speed should be other than 3119 bits per second - the 
default value -enter the appropriate line sneed in the 
Rieregister. See the paragraoh below and Table 3-1), 

i. Press Ready. 


j. Press Execute. 


The erator terminal is selected as follows! 


Ze 


If there are one or more terminals connected to an MDC, the 
one with the lowest channel nunber its selected, 


[f there are no terminals connected to an MDC, there must be 
9n2e or more terminals connected to an MLCr/DLCP. In this case, 
the MLCP/DLCP=-connectad terminal with the highest channel 
nunber is the operator terminal. 


Since a communications terminal can run at different line 
speeds, you nust determine the connect line speed of the 
terminal with the hignest channel number 3nd then, in the 
Qrocedure described atove, when the TRAFFIC light turns off in 
step 3h, you enter the correct line soeed in the Ri-register. 
The default value {ts 9110 bits oer second. 


vomaletion of system startup is signalled by the message shown in 
Figure 3+2. [f your terminal is connected to an WDC, don’t press any 


terminal keys until after the system startup message anpears. If you 
19, you can recover by pressing the BREAK key. 


($H)$SH Group ready! 


NOTE See the accomoanying text for an explanation of 
the variables in the first line. 


Figure 3-2. System Startup Typeout at Qoerator Terminal 


The system startup message, shown in Figure 3-2, is interpreted 4s 
follows t 


e ($8)GCO0S6 MOD400 = arrr = mm/dd/shnn 


Indicates the comoletion of system startup. A is S for a SAF system, 

L for a LAP system. rrr indicates the release ninber of the system 
Executive. mm/idid/hrhnn indicates the date/time when the Executive 

was linked (fttonth, day, hours, minutes). ) 


e ($35)$H Group ready! 


Indicates that a user taks group, which has the command processor as 
its lead task. is ready for the entry of comnanjs. This task jrous 
has heen spawned by a command in >SID>START_UP.EC. The typeout is 


($5)GC0S6 M00400 = arrr =nn/-ad/hAnn 
the result of a command in the supplied »HIS>STARTLUP.EC file. 


Table 3-i. TTY Terminal Line Soveds 


Type 2100, 2110, or 2118 
Type 2108 communications-Pac Communications=Pae 
Speed Speed 
(Entered tn RiJ-Register) (Entered in Ri-Rezister) 


NOTE? A soeed of 0134 represents 134.5 bits/second. 
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STASE 2 SYSTEM STARTUP_CINTERMEDLATE SYSTEM STARTUP) 


A staje 2 system startup can be performed only after you have 
created your own file of CLM directives, named CLM_USER under 
directory SID on the bootstrap volume. The contents of CLM_USER 
should described the environment you wish to use for application 
development. 


creating CLM_USER 
The recommended approach for creation of CLM_USER is shown helow, 


I. rollowing a stage i system startup, invoke M4_SYSDEF to run 
under task grouo SH. Although you can create the CLM_USER file 
directly by using the Sditor, CII HONEYWELL BULL recommends 
that you use M4_SYSDEr, the interactive system building 
Orogram, even if you have buili the system before, See Section 
[IV for a complete description Of how to use M4_SYSDEF. 


2. After creating a CLM_USER file usiny W4_SYSDEF and placing it 
immediately subordinate to directory SID on your bootstrap 
volume, continue with the steps necessary for a stage 2 systen 
startup. 

If you wish to create your own CLM_USER file without using 
M4_SYSDErF, or {f you wish to modify the existing CLM file to reflect 
changes in your installation’s configuration, follow steos |! through 
7 below to use the Editor. 


USINS THE EDITOR 


1. Following a stage | system startup, {nvoke the Editor to run 
uner task group SH, 
You may be reaquired to change the default task group of the 
operator’s terminal from the $S (Systen) task group to the $H 
task group. Enter the followin) lines at the operator’s 
terminal {mmediately following system startup: 


C SH: (transfers default task grouo of the oper3tor’s 
terminal from $S to Sit task group). 


RON (The ready On (RON) command causes a pronpt 
message to aopear at your terminal. This command 
{s for convenience only and is not required). 


If you have entered RON, the system will respond with the 
prompt message! 


(SH)ROYs 
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Note that no prompt message appears unless you specified RDN. 


You are not ready to invokes the Editor, as described in the 
Commands manual and the Program Preparation manual. Sample 
Editor work sessions are provided in the Programmer’s Guide. 


2. If you are modifying an existing CLM file, use the Editor’s 
read directive to read the file’s contents into the Edttor’s 
“currant buffer". If you are creating a CLM file, go to step 
De 


3. Jse the Editor’s print directive to orint out the entire 
contents of the current buffer. 


4. Inspect the printout and identify the jifferences between the 
contents of the current buffer and your desired file CL¥ 
directives. 


5. Use the Editor’s insert, change, aopend. and felete directives 
to modify the contents of the current buffer so as to define 
the CLM directives that describe your application develonment ,, 
configuration. Se 


4. Use the Editor’s print directive to orint out the entire 
contents of the current buffer. Ensure that the contents 
accurately reflect your desired CLM directives. (If any 
corrections are necessary, repeat stenos 5 and 4). 


7. Use the Editor’s write directive to write the entire contents 
of the current buffer to >SID>CLM_USER. (You may give your CLY 
file any name you wish, althoujh it ts recommendeg that you 
call it CLM_USER. Note that the Configuration Load Vanager 
must be able to Locate a file named CLM_USER at system 
startup. 


Staje 2 Startup 


vne you have defined the desired contents if >SID>CLM_USER, you can 
oerform a stage 2 system startup by taking the following steps: ) 
eel 


}. Ensure that the central processor control panel’s POWER switch 
{s JUN and turn on power to all eauipment. 


2. Ensure that the volume containing the CII HONEYWELL 
BULL=suoplied system software is mounted on the hootstrao 
device, 


3. Perform the following bnotstrao scrocedure at the central 
orocessor control oanels 


&@. Press Stop. 
db. Press CLeaR. 


Wait for CHECK light to go ut. 
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c¢. Press Load. 
d. Press Execute. 


e. Wait for the TRAFFIC light to turn off. (If the Pootstrap 
channel is not 0400 and/or if any of the bootstrap options 
describes in Table 3-2 are to he used, see "Operator’s 
Startup Actions,” later in this section). : 


f. Press Ready, 
3. Press Execute. 


Tne system is bootstraoped into main nemory. The CLM_USER 
file in directory SIO is read by the Configuration Load 
Manager and the system is configureJj accordingly. 


A system task grouos ($5) {s spawned. The Operator commands 
in the CII HONEYWE’.L BULL=supplied *root_direc tory 
>START_UP.EC file are executed, causing a user task group 
($H) to be spawned. 


Systen startup is complete. The system startuo message is issued at 
the Operator terminal, which, in the case of a stage 2 system 
startuo, {is the terminal associated with logical resource nmimber 
C(lrn) 3 in a CLM directive. (If the operator terminal is connected 
to an MLCP/ILCP, the terminal’s line speed and sther conmuntcations 
characteristics are defined in a CLM Jjirective). 


If a CLM directive in CLM_USER contains an error caused by incorrect 
syntax or if the CLM directive 1s an invalid duplicate, an error 
nessaje will aovear at the Operator terninal (tf vossible). Sse 
"Configuration Load Manager Error Reoorting" at the end of this 
section. If an uncorrectable error prevents sucessfil completion of 
a stage 2 system startup, it {s possible, by neans of the 
appropriate bootstrap option (see Table 3-2), to Synass the CLM_USFR 
fiie and perform a staje | system startuo using one of the two 
suoplied files of CLM directives. This technique allows you t9 
remestabdlish a limited system configuration ir which you can use the 
editor or M4_SYSDEF to correct CLM_USER before reattempting 4 staje 
2 system startun. 


Note also that the supplied START_UP.2C file directly subordinate to 
the bootstrap volune’s root directory is nornally not modified prior 
to a staje 2 system startuo. 


Once a satisfactory stage 2 system startup has been achieved, you 


can use the resulting system for anolication development or as 43 
neans of gaining experience in the use of the systen software. 


3-09 


STAGE 3 SYSTEM STARTUP (FULLY~SPECIALIZED SYSTEM STARTUP) 


4 stage 3 system startup is very similar to a stage 2 system 
startup. The principal difference is that application development 
performed following a stage 2 system startup provides you with 
information you may wish to use in refining the CLM directives in 
your CLM_USER file. For example, you may wish to change certain 
YEMPOWL directives and/or cause certain system overlays to be made 
permanently resident. Moreover, you may wish to describe additional 
nerfoheral devices that were not previously tdentified in CLY_USER 
because they were not used during anolication development. 


Thus, orior to performing a staje 3 system startup, you will 

prohably have used the Editor or M4_SYSDEF to undate the contents of 
CLM_USER. Additionally, you must decide whether to retain, modify, 

or delete the START_UP.EC file tmmediately subordinate to the 

Seotstrap volume’s root directory ({.¢e., the START_UP.EC file used 

in a stage 2 system startuo). If you wish to retain this 

STAQT_LUP.EC file in its original condition (but not use it during a 
stage 3 system startup), you may use the RENAME command. ) 


The steps performed in a stage 3 system startup are identical to 
thos2 used for a stage 2 system startup except that the 

“root _directoty>START_UP.EC file may have been modified or deleted, 
If this file exists at the time of a stage 3 system startup, all 
Qperator commands therein will be executed, 


SUYMAQY OF STARTUP PROCEDURE 


The following paragraohs and Figure 3-3 summarize the startuo 
procedure. 


cvery time the system is bootstrapoped, 4 software component 

ascertains whether an initially~supplied or 4 user-created file of 

cLM directives {is to be read by the Confijuratiton Load Manager. If 

an initially=-supolied file 1s used, a software algorithm also ») 
ascertains whether the operator terminal {s to be an MDC-connected , 
terninal or an MLCP/DLCP-connected terminal. If a user-created CLM 

file is used, a CLM directive dictates which device is to be the 
operator terminal. 


Juring a system startup in which an initially-suoolied CL file is 
used (i.e., 2 stage |] system startup), operator commands in the 
START_UP.EC file itn directory >SID will be executed. During 3 stajze 
2 system startup (userecreated file of CLM directives used), 
Operator commands in the suxplied START_UP.EC file under the 
bootstrap volume’s root directory will b executed. During a stage 3 
system startup (refined user-created file of CLM directives used), 
Operator commands in the START_LUP.EC file under the bootstrap 
volune’s root directory will be executed tf such a file is present 
either in its original form or as modified by the user. 
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3-3. Flowchart of System Startuo Process 
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CONFIGURATION PHASE 


SEARCH “ROOT FOR ee 
310 CLM_USER 
_) 
ee” 
YSECLM USER AS 
tPUT TO CLM 
LOAD AND USE CLM _MCP as 
EXECUTE CLM INPUT TO CLM 
ft SP FOR CAMTIHIDK OFSK ) 


J) FOR MASS STOHAGE UNIT 


AT COMPLE TION OF 
CONFIGURATION, 
CREATE 4 SYSTEM 
GROUP USING & 
WORKING DIRECTORY 
OF “ROOT $10 


AT COMPLETION OF 
CONFIGURATION, 
CREATE & SYSTEM 
GROUP USING & 
WORKING DIRECTORY 
OF “BOOT 


SYSTEM GHOUF 
STAHTUH PHASI 


Figure 3=3 (Cont). Flowchart of System Startup Process 
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SYSTEM GROUP 
STAATYP 


SEARCH FOR STARTUP EC 
IN THE WORKING DIRECTORY 


EXECUTE tT [SAMPLE 
COMMANDOS FOLLOW! 


COMMAND FILE 


PRINT “SYSTEM 
GAouP STARTUP 


SPAWN & $H 
USER GROUP 
PRINT SYSTEM 
GROUP READY’ 


SYSTEM GROUP 
IS NOW READY 


SYSTEM GAOUP 


IS NOW READY 


SEAACH FOR STARTUP EC 
iN THE WORKING OIRECTORY 
ASSIGNED TO THE NEW GROUP 


EXECUTE tT (A SAMPLE 
COMMAND FOLLOWS? 


PRINT USFR 
GROUP READY | 


USER GROUS IS 
NOW HEADY 


Figure 3-3 (Cont). Flowchart of System Startup Process 
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Operator’s Startup Actions 


The Operator’s actions at system startup are as follows: 


i. Set the central processor control panel POWER switch to ON, 
Turn on power for all devices, 


26 


Ensure that the volume containing the CII HONEYWELL 
BULL~supplied system software is amounted on the bootstrap 
device. 


Perform the following bootstrap procedure 3t the central 
processor control panel? 


as 


ne. 


C4 


ft. 


Press Stop. 

Press CLeakR, 

Wait for CHECK Light to go out. 

Press Load. 

Press Execute, 

Wait for the TRAFIC light to turn off. 

If the bootstrap channel is not 0400 and/or if any of the 
bootstrap options shown in Table 3-2 are to be used, 
perform the following steps: 

(1) Press Stop. 


(2) Press Select. 


(3) Press DI on the hexadecimal keyoad, so that D1! appears 
in the LOCATION indicators. 


(4) Press Change. 


(5S) Press appropriate keys on the hexadecimal Keypad so 
that the CONTENTS indicators show the desired hootstrao 
channel and options. 


(6) Press Run. 
Press Execute. 


The system is bootstrapped into main memory. (If the 
bootstrap halt option was specified ii step e(5) ahove, the 
central processor halts, with Di equal to what was entered 
in step e(5), as soon as the system has heen bootstrapped3 
after performing any desired actions, again press Execute 
to continue. If Stop, 2un, or Arite was invoked in these 
actions, press Run and Execute ts continue). 
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‘in a stage | system startup with an MLCP/DLCO-connected 

Noe Operator terminal, wait for the TRAFFIC light to turn offs 
then ensure that tre Ri-register contains the proper Line 
speed for the ooerator terminal and press Execute to 
continue). 


Table 3-2, Bootstrap Jptions 


Bits in Low-0Order 
Digit of 4-Digit 
dexajecimal Boote- 
strao channel 


a 
Number Meaning if 31t Set ON 


15 After the initial bootstrap record is read from 
(low-order bit) the removable olatter of the cartridge disk whose 
C channel number is contained in bits 0 through 9, 
the remaining recorjis are read fron the fixed 
platter. 


: Ignore CLM_JUSER file if it exists under directory 

“4 SID. Instead, use the suoolied file of CLM 

+ directives aporopriate to the bootstrap device and 
terminal configuration (i.e., CLMY_MDC or CLMLMCP), 


The central processor halts after the systen is 
bootstrapped and before execution of the Executive 
begins. and before execution of CL’. (To continue 
after the halt. press Execute). 


a 
These bits may be set ON in any desired combination. Thus, the 
value of the loweorder digit of the 4-dijit hexadecimal bnotstrap 
channel nu.nber may range from 0 (no options) to 7 (all options). 


System startup Actions 
Systen startup actions continues without further operator 
intervention. 


1, The Configuratio.. Load Manager reads CLM directives fron the 
appropriate file: 


a. Ef CLY_USER does not exist in directory SID on the 


Bootstrap volume, one of the two CII HONSYWELL 
BuLL-supplied files is used. 
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2. 


3. 


(1) CLM_MDC ts used if the bootstrap volume is a cartridje 
disk, cartridge module disk, mass storage unit, or 
diskette, and one or more terminals are connected to an 
MDC. (The terminal with the lowest channel number will 
be used as the operator terminal). 


(2) CLM_MCP is used if the bootstrap volume is a cartridge 
disk, cartridge module disk, Nass storage unit, or 
diskette, and one or more terminals are connected to an 
MLCP/OLCP. (The terminal with the highest channel 
number will be used as the onerator terminal). 


b. If CLM_USER does exist under directory SID on the baotstras 
volume, {it will be used unless bit 14 of the bootstrap 
channel is set ON, in which case One Of the system actions 
described under a (above) is followed. 


The system task jyroud is created as if the following command 
has been executed, without user intervention: 


SG (spawn group command) 
$$ ( task_jroup_id) 
OPERATOR -SYSTEM.0PR (userid) 
highest priority Level (base _priority_level) 
* 2 in CLM directive 
ICON SOLE (in path, also 

out_oath by default) 

~ECL (lead task) 

“LRN highest Irn tn (highest Irn) 

CLM directive 

“LEN 15 (highest lfn) 

“POOL system oool (memory poll) 

“WD “root_directory if (initial working 

CLM directives were directory) 


read fron CLM_USER? 


SID {¥f CLM direce 
tives were read from 
CLM_MDC or CLY_MCP. 


4 systeme-suoplied START_UP.EC file ts in directory SID: its 
Operator commands are executed when a2 stage ! system startup 
is performed (1.@., wien CLM directives are read from CLM_'4DC 
or CLM_MCP), Another system-supplied START_UP.EC file is 
immediately subordinate to the root directory of the bootstrap 
volumet its operator commands are executed when a stage 2 
system startup is performed. 
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Boti, START_UP.EC files cause a user task group ($H) to be 
soawned. The working directory for $H is HIS, which in turn 
contains a system-supplted START_UP.EC file that oerforms a 
CWD (change working directory) to “rnot_directory. 


‘Regardless of which file of CLM directives is used, the 
working directory for the system task group ts always 
“root.directory at the end of system startup. 


4. The system startup typeout (see Figure 3-2) is issued at the 
operator terminal. 
When system startup is complete, as signified by the system startup 
typeout, operator commands may be entered to the system. 


CONFIGURATION LOAD MANAGER SRROR REPORTING 


If, when the Configuration Load Manazer is reading CLM directives 
from CLM_USER, £t detects that a directive contains a syntax error 
or is an invalid duplicate of another CLM directive, it {ssues (if 
possidle) a 2-line error message at the operator terminal. The 
nessage has the format shown helow: 


($5) (t3yyzz) hh 
secondary message indicating the CLM directive causing the error 


yy ~ code identifying the system comoonent that has detected the 
error 


zz = error code (see the System Messages manual) 


An = priority level of tne task group executing the Configuration 
Load Manager 


You can ({f appropriate) byosass the error by typing * (asterisk) at 
the Operator terminal and pressing RETURN. Otherwise, you must enter 
a correct CLM directive through the operator terninal and press 
RETURN. The remainder of the CLM directives in CL'Y_USER will then he 
processed. 


An error message cannot be {issued if an overator terninal is not 
available because (1!) the CLM DEVICE directive for an MDC-connected 
operator terminal has been omitted or (2) the operator terminal is 
connected to an MLCP/DLCP In which case it is not operational until 
System startup is complete or (3) the error oecurred hefore the 
DEVICE directive defining the console was read. (For this reason, it 
is tnportant to place the directive early in the CLM_USER file). In 
these cases, errors are reported through the hardware registers 
shown below, which are accessible through the central vrocessor 
control panel. Refer to Section V in the Miniconouter Systems 
Handbook (CC71) for procedures tn follow in reading out registers 
and memory locations. 
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Rl-register contains yyzz (as described above) 


R2-register Zzro or a l=-word secondary message in hexadecimal ~~ 
notation. 


R4-register zero or the address of the first word of a secondary 
message in ASCII notation (the left byte of this word 
is a control byte) 


‘BS3-register zero or the address of the first word of the CLM 
directive causing the error provided the error occurred 
before the QUIT directive. 


As described earlier in this section, in the event of an 
uncorrectable error in CLM_LUSER, it is possible to return to a stage 
{ system startup (using the appropriste bootstrap ootion) and 
re-create a limited system environment in which “M4 _SYSNEF or the 
Editor can be used to correct the error in CLM_JUSER. 


See Aopendix A for information about other halts that are possible 
during system startuo. _) 


« 


=) 
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SECTION IV 
USING M4_SYSDEF 


M4_SYSDErF, an interactive program that generates a CLM directive 
file, is provided for your convenience in creating the CLM_USER 
file, and is fully described in this section. 


The system building CLM directives themselves are described in 
detail in Sections V and VI. Note that some of the directives = and 
thus some of the MOD 400 software - are not sunported by M4_SYSDEF. 
See “d44_SYSDEF Operating Considerations", later in this section. 


INTERACTIVE SYSTEM BUILDING PROGRAM 


The interactive CLM directive generation program M4_SYSDEF Is 
designed to help you create the CLM directive file CLM_USER. It 
converts information you give it, in response to its prompts, into 
the CLM directive file. M4_SYSDEF is designed to produce a 
Girective file adequate for the average user and which will always 
result in an Operate MOD 400 Executive. 


Although you can create the CLM directive file directly, usiny the 
Editor, CII HONEYWEIL BULL recommends that you use M4_SYSDEF, even 
if you have built the system hefore, because M4_SYSDEF: 


« [s interactives it prevents you from forgetting any necessary 
infornation. 


e Tests each of your responses for validity. 
e Ineludes online explanatations of each of its pompt messages. 


« Ensures that a comolete, oroperly ordered directive file is 
oroduced, 


» Allows you to interactively add, delete, or modify information 
you snecify at any point in the program, 


« Performs all calculations of memory required by your Executive; 
the resulting memory sizes should never be less than your 
requirements. : 


- dsuilds in all hardware devices sunoorted by CI1 HONEYWELL 3JIL. 
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- Generates, at your option, symbolic perioheral device names for 
all devices in your configuration. 


. Senerates, at your option, channel number assignments for all 
noncommunications devices in your configuration. 


» Produces, at your option, a listing of the directive file at 
your terminal, before generating the final output file. 


« Automatically generates a file containing configuration 
information that enables you to verify the success of certain 
aspects of the system building process. 


» At your option, automatically configures all asynchronous 
communications devices (TTY and ATD) as heing reconnectable in 
the event of a power failure or line drop. 


Appendix M contains a checklist for your convenience in gathering 
the taformation M4_SYSDEF requires. Appendix C lists the hardware 
avatlable under WOD 400, 


Required Resources 


M4 SYSJEF requires I|OK words of memory to operate. It can run in the 
MOD 400 minimum system. 


M4_SYSDEF Operating Considerations 


You snould consider the following when executing M4_SYSDEF: 


1. If you allow M4_SYSDE* to dynamically assign channel nimbers 
to your devices, you will only need to suoply channel numbers 
for MLCP/OLCP = connected (communications) devices. If you do 
not choose this option, you will be asked to explicitly 
specify channel numbers for all devices tn your configuration. 
(See Section V for information on dynamically assijzned channel 
assignments for non-communications devices). 


2. If you choose to let M4_SYSDEF stsoply the channel numbers for 
all non-communitcations devicest 


» M4_SYSDEF will assign the channel to be used for the 
Operator terminal. If the operator tarminal is to be an 
MDC-connected terminal, the srogram uses the device with the 
numerically lowest channel number as the Operator terminal. 
If the Operator terininal is to be an MLCP/DLCP-connec ted 
terminal, the program uses the sdtevice with the numerically 
highest channel number as the operator terminal. 


. M4_SYSDEF will ask you to snecify the tyne of device you 
plan to use as the boot device, 
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If you do not choose to sunoply symbolic peripheral device 
(SPD) names, M4 _SYSDE2 automatically generates a unique SPD 
nane for every device configured. If you chnose to provide 
your Own SPD names, M4_SYSDEF will ask you to specify them as 
needed. : 


CIi HONEYWELL BULL recommends that you use the following 
symbolic peripheral device (SPD) name conventions {if you wish 
to provide your own SPD namest 


Symbolic 
Peripheral 
Device (SPD) 


Name Device 


LPTnn Line Printer 

SPTnan Serial Printer 

CONnN MDC-conmnected Terminal 

CDRnan Card Reader 

CRP nn Card Reader/Punch 

OSK an Discette 

aco nn Removable Cartridge Disk 

reCDnn Fixed Cartridge Disk 
eCinn Fixed Cartridje Yodule D1sk 
RCMno Removable Cartridge Module Disk 
MSM nn Mass Strorage Unit 

MT9 nn Magnetic Tape (9-track) 


CIL HONEYWELL BULL recommends configuring Distributed Systems 
Facilities software e.3., File Transmission Facility HASP 
Workstation Facility, etc. after you have Suilt your system 
the first time. This software is described in this manual’s 
400end i xes. 


M4_SYSJEF doesn’t support the following: 


configuration of dual-nurpose oserator terminal 
User=-written line orotocol handler (LPHn) 
AutoCall Unit (ACU) 

7-track tape devices 

Device or memory error Logging 


6 e# *# 8 @ 


The pro yram converts all lowercase characters {in your 
responses to uopercase characters, unless you enclose the 
lowercase characters in apostrophes (%). 


When you enter channel number assignments, the program 
verifies that: 


+ Tha channel number {s in the proper format (i.e., that {it 
contains exactly four hexadecimal characters and ends with 
either "O00" or “80%) 


» The channel number isn’t already assigned to another device 
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« The channel number Isn’t less than 0400 or greater than FF8) 


Since there is no requirement that system building takes olace — 
upon the target machine, or that any soecified device actually 

be attached to the machine when M4-SYSDEF is executed, the 
orogram doesn’t verify whether the specified channel is 

actually connected to a device whose tyse matches the one in 
question. Therefore, Lf you enter invalid channel number 
assignments, the directive file will be in error. 


MODIFYING YOUR CLM OIRECTIVE FILE 


If you make mistaskes tn soecifying your directives when running the 
M4_SYSDEF program, or, if you wish to chanje, add, or delete 
infornation, you have several ootions for making modifications? 


e YOu can taterrupt the program at any Ddoint to modify any 
portion of the CLM file. To do this, enter C BSH, and ;) 
following the BREAK message, enter the program interruot (°F) a 
conmand. (It is assumed that you are entering the M4_SYSDJEr 
progran from the operator’s terminal. [f you are not at the 
operator’s terminal, »ress the BREAK key, and following the 
BREAK message, enter the PI command). The M4_SYSDEF orogran 
will respond by asking you which class of device or system 
parameter you wish to todify. Desenting on your reply, the 
program will ask you only those questions in the 44_SYSO&r 
dialog that pertain to the specific device or system parameter 
that you wish to nodify. 


« You can finish running the prograu and do one of the following: 


~ Invoke M4_SYSDEF again, this time specifying the oathname of 
your restart file. The M4_SYSODEF srogram will enter rebuild 
mode and will ask you to specify the class of devices, or 
system varameter that you wish to modify. See "Using 
M4_SYSDEF in Webuild Yode," below, ) 


- Invoke M4_SYSDEF again and redefine the entire file. 


- Use the Editor to edit the file directly. 


USING M4_SYSDEF IN REBUILD MODE 


Using the M4_SYSDEF program in rebutld mode allows you to enter the 
program dialog at any point to make changes to an existing CLM file. 
The M4_SYSDEF program will only ask you those questions in the 
dialog that pertain to the specific device, class of devices, or 
system parameter that you wish to modify. Because you need not step 
through the entire M4_SYSDEr dialog in sequence to get to the 
section(s) you wish to modify, you can make random modifications 
quickly and easily. 
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The first time you create a CLM file using M4_SYSDEF, the program 
Jenerates a CLM directive file and a file containing information for 
the rebuild function, called the restart file. Each time you modify 
a CLM file, the M4_SYSDEF program creates @ unique corresponding 
restart file under the same directory as your CLM file.(t) Whenever 
you terminal the M4_SYSDEF program normally the full pathnames of 
your CLM file and {ts corresoonding restart file are displayed at 
your terminal. You never assign a name to the restart file - the 
M4_SYSIJEF program does this for you automatically. You need only he 
aware of the pathname of the restart file that corresponds to the 
CLM directive file you wish to modify. 


If you wish to modify a CLM file at some later time, you simply 
invoke M4_SYSDEF and soecify the pathname Of the corresponding 
restart file on the command line. The M4_SYSDEF program reads your 
restart file. See "M4_SYSDE= Dialog In Rebulid Mode" later in this 
section for a complete description of the rebuild mode dialog, 


(i) 

Thera is no limit to the number of restart files that the M4_SYSDEF 
program creates. You must delete restart files which are no longer 
needed with the delete file (NL) command, as described in the 
Comnands manual. 


OUTe JT OPTIONS 


You have several outout options when using M4_SYSDEF? 


}, You can request M4_SYSDEF to List all the CLM directives {tt 
has SUuilt for you. If you spet any errors at this point (or at 
any point during the tnteractive dilalojue) you can verfornt any 
one of the actions described above under "“YWodifying Your CLM 
Jirective File”, 


2. You have the option of creating a CLM_LUSER file which contains 
the jyenerated directives or you can terminate the interactive 
session. If you have not listed the CLM directives and you do 
not wish to create a file using them, M4_SYSDEr warns you that 
the directives will be lost and orocessing will terminate, and 
asks if thts is what you {tntend. 


3. You have the option of giving your directive file a name other 
than the default file name CLM_USER.(1) After you smecify a 
file name, M4_SYSDEF creates the file under your current 
working directory, assimed to be (but not restricted to) 
directory SID in the rest of this section. 


(1) 
If a CLM file already exists in your working directory, M4 _SYSNEF 
cautions you that your new CLM file will renlace the existing one, 
if both have the same file name. 
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Invoxing M4_SYSDEF 


Before tnvoking M4_SYSDEF, you are reaulred to transfer control of 
the soerator’s tarminal from the $S task group (the system 
operator’s task group) to the SH task group (a system=supplied user 
task group). (If the terminal ts already under control of the SH 
task jrouo, proceed to the oaragraonh below that describes how to 
change your working directory to the directory SID.) Enter the 
following lines at the Operator’s terminal immediately following 
system startup? 


Crwsls( Transfers control) of the operator’s terminal from $S to $H 
task group) 


RON (The ready on (2DN) command causes a4 orompt message to appear 
at your terminal. This command is for convenience only and is 
not required). 


If you have entered RDN, the system will resoond with the prompt 
messajzet . ; ) 
~~ 


(SH)RDY# 
Note that no prompt message apoears unless you specified RDN. 


Next, change your working directory to the dfrectory SID by 
entering 


CAD »SID 
Then Lavoke M4_SYSDEF by entering: 
M4_SYSDEF (path) 


where the optional argument (path) soecifies the oathname of a 
system-supolied restart file. The ocathname must de of the forn 

M4RST.n where on is an integer. You specify this argument only if you 
wish to enter the M4_SYSDE- program in rebuild mode to modify an 
existing CLM file. See "M4_SYSDEF Dialog In Rebuild Mode" later in ) 
this section. 


You can terminate the interactive session at any time by entering C 
3SH and then, following the BREAK messazje, using the unwind (UW) 
cammand. (It Ls assumed that you are at the operator’s terminal. If 
you are not at the Operator’s terminal, oress the BREAK nessaje, 
enter the UW comand). [f you make a mistake while creating the 
directive file, follow one of the options described elsewhere in 
this section under "Modifying Your CLM Directive File." 
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Prompt Moaes 


M4_SYSDErF Operates in two oromot modes = long and short. In the long 
mode, each question is preceded by a multiline onscreen explanation 
of the question being asked. In the short mode, only the question its 
asked. Users of the short oromot mode who need help can see the 
long explanation printed as a "help message” by asking for helo (see 
below). 


M4_SYSDEF asks you which mode you want to use when you tnvoke the 
orogram. If you select the long mode, the explanatory text anoears 
only once. If the program repeats the question (because, perhans, 
you answered it incorrectly), the short prompt is repeated unless 
you asx for help. It is recommended that first-time system builders 
execute M4_SYSUEF in the long prompt node. 


M4 SYSDErF DIALOGJE 


The short mode prompt nessages which make uo the M4_SYSDEF dialogue 
are listed below, in order of their saopearance. Unless otherwise 
noted, these resosonses are always acceptable: 


- ? ~ Help 
- YES or Y ~ Yes (for/yes/no questions) 
« NO or N = No (for yes/no auestions) 


e QO, NONE, or N = None (for questions requiring a numeric 
response) 


A response of [C/R] (RETURN) is never acceotable (i.e., there are no 
jJefault resoonses), 


Qnce you invoke M4_SYSUEF, {it responds with’ 


Hello! This tool will help you generate the file containing the 
Confijguration Load Manager directives (the CLM_USER file), which ts 
necessary to build your GCO0S6/M0D400 Ooerating 5 eat No you wish 
to use the long oromot mode? 


- In the long mode, every prompt messaje {5s oreceded by the text 
of the “help"™ message, explaining what the requested 
information is, where you can find out if you »ave it or need 
ft, and/or what will anoen if you supply certain values. 


In the short orontot mode, only the prompt message is displayed, 
unless you enter?. Entering? doesn’t chanje the mode, 


e Acceptable answers are YES, Y, NO, or N, aN 
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Mhat is the total amount ({n words) of real memory on the machine 
this system {s to run On? Enter the value in the form? nnnk. 


- This value is the total amount of real (physical) memory 
installed on the machine for which this system {s being built. 
The value you enter may differ from the amount of memory of the 
machine on which you invoke M4_SYSDEF. The minimum 
configuration for MOD 400 ts 48K words, 


. Acceptable answers range 48K to 1024K. Consult Appendix C for 
iaformation about minlmum system requirements. 


Do you wish the system to supply the channel numbers for 
non-communication devices? 


« every peripheral device attached to the system must have a 
megabus channel number assignment. The program can use the 
floating channel feature (see Section V) to relieve you of the 
responsibility of assigning channel numbers to 
noncommunications devices’ note, Nowever, that you must always 
provide channel numbers for comnunt{tcations devices. 


« Acceptable answer are YES, Y, Nid, or N. 


- [If you reply YES, the program will ask you to suoply devices 
types for the operator’s console and the boot device. 


- If you reply NO, the program will promot you to supply 2 
channel number for each device in your configuration, 


znter the channel number of the operator terminal which will he the 
CONSOLE. 


> You Must specify the channel to whtch the ovoerator’s terninal 
is cOnnected. M4_SYSDEe verifies for you that this channel 
number nas not already been assigned to another device, 
However, only you can verify that the specified channel Is 
actually connected to the terminal destznated as the operator 
terminal for your installations “4_SYSDEF cannot check this 
information for you. ; 


« The channel number specified must consist of four hexadecinal 
characters ending itn °00% or ’807, 


Enter the channel number of the boot device. 


« You must specify the cnanmnel number of the irive on which you 
Qount the disk containing the system software, 


« The channel number specified must consist of four nexadecimal 
characters ending in “00% or ’807, 


« This prompt does not appear if you specified that “M4_SYSDEPF 


will supply the channel numbers for all non=comnunicat Lons 
devices in your configuration. 
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Jo you wish to Soot the fixed platter? 


e 


This promt applies only if you wish to boot from the fixed 
platter of a cartridge disk or cartridge module disk. 


Coad 


Acceptable answers are YES, Y, NO, or N. 


Is this a Commercial System? Reply "yes" or “no"™. 


Will 


Nill 


vill 


* 


If you have a Model 47 or Yodel 57 central processor, answer 
Yes. If you have any other model central srocessor, you must 
answer NQ, 

Acceotable answers are YES, Y, NO, or N, 

If you respond NO to this question, the program replies: 

this system have a Commercial simulator? 

If your system isn’t a commercial system, it may reauire the 
commercial instruction sitmulator. Otherwise, it won’t he able 
to execute commercial instructions (used, for instance, by 
immediate COBOL). 

Acceptable answers are YES, Y, NO, or N. 

this system have a SIP? Reply “yes or "no", 


The SIP is the Scientific Instruction Processor software 
oo tion. 


Acceptable answers are YES, Y, NO, or N. 

{f you reoly NO to this cuestion, the program repliest 

this system have a simulator for the SIP? Reply "yes" or “no, 
Acceptable answers are YES, Y, NO, or N. 


If you reply NO, then the system won’t he able to sunport 
scientific instruction (used, for instance, in FORTRAN), 


If you reply YES to this question, the orogzram repiies? 


Yo you want the double precision simulator SIPSI'M? 


ia 


ecceptable answers are YES, Y, NO, or N. 


If you reply yes, the double=precision simslator will give you 
twice as nany significant digits fa your FURTRAN calculations 
as the single~precision sinmilator. (If you chose this ontion, 
Me aware that numerical values stored in memory will take ‘ip 
twice as much soace as values stored for the single-precision 
s{mulator). 
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The default system identification ts "GCOS6/M0D400",. [f you wish to 
change it, reply “YES"s if you do not wish to change {t, reply “No". 
Vo you? eae 


« Tre system tdentification message appears as a comment line 
near the top of the CLM file that M4_SYSDEF generates for you. 
You may, if you wish, customize this message for your 
installation’s CLM directive file. 


. Acceptable answers are YES, Y, NO, or N. 
- If you reoly YES to this question, the program repliess 


Cnter the new System [Identification (30 characters or less) in the 
forms “’SYSTEM_IDENTIFICATION 


- You must enclose the entire string in anostrophes, as shown. 


The default installation identification is “Your Town, USA’. If you 
wish to chanjze it, reply “Y2S%% Lf you do not wish to change it, 
reply “Nu%,. DO you? 


« The installation ldentification nessage anoears as a connent 
line near the too of the CLW file that W4_sySDOr generates for 
youe You may, if you wish, custom{ze this nessage for your 
{astallatiLon’s CLM directive file, 


» Acceptable answers are YES, Y, NO, or N. 
» If you reoly YES, the program responds? 


Enter the new installation tdentification (30 characters or less) in 
the form: “Installation td? 


« YOu must enclose the entire string In anostrophes, as shown. 


Please enter the maxtaum number of concurrent users that you expect 
this system to supsort. 


« This value allows for the calculation of some of the system 
structure sizes and memory needs which vary desending upon the 
maximum load for which the system ts to be built. M4_SYSOEF 
assumes that the number of users is synonymous with the number 
Of task groups. 


« Note that enterin3 2 given number here does not guarantee that 
the maximum number of concurrent tisers can in fact be 
supported. This depends on such dynamic variables as the work 
each user is performing and memory fragme.utation. 


« Nonnumeric characters are not acceotable in this answer. 
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Should I automatically generate the SPD names for you? 


» zach peripheral device attached to the system must have 43 
symbolic serioheral device name. This entry {is 3 five-character 
name which conforms to the file systen naming conventions. 


. Acceotable answers are YES, Y, ‘t), or N. 


. If you reoly YES, the orojram will generate Secharacter SPD 
names without further prompting. If you reply NO, the orogram 
will srompt you tn supply an SP) name for every device in your 
configuration. 


Jo you wish this system to activate the Record Locking Feature of 
Data Management? 


« Record Locking is the finest granularity of concurrency control 
orovided by data nanagement. Activation of this rtuntine option 
allows more than one user to write records to a given file 
simultaneously. Proper tisage of this ootion ensures that all 
updates are correctly aoplied to the file. 


« Acceptable answers are YES, Y, NO, or N. 


« If you reoly YES, recsrd locking ts inplemented. I[f you reoly 
NU, data management will enforce file level concurrency (1.¢., 
only one user can have write pernission on 4 file at one time). 


Qo you wish to include Display Formatting and Control Software? 


- The Display Formatting and Control software its described tn the 
Uisplay Formatting and Control manual and ia Appendix P of this 
manual. 


« Acceptable answers are YES, Y, NO, or ‘N. 


- If you reply, YES, the display processing software will be 
tneluded {n your Executive. I[f you reoly NO, no disolay 
processing software will be included. 


Do you wish to activate the power fall restart? 


« This prompt asks {f you wish to configure the power resumption 
facility. The power resumption facility allows the system 
execution environment to be restarted after a power 
interruption, {f fewer than two ours have elasned when power, 
{s returned to the central processor. for more information, 
refer to Appendix 0. 


. [f you reply YES, eaen ATD amd TTY communications 
(MLOP/OLCP=<connectad) device in your configuration will be 
automatically reconnected if a power resumption or line droo 
cOnditfon occurs. (Perloheral devices not attached to an 
ALCP/OLCP are automatically designated as reconnectable when 
tney are configured). 
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If you reoly NO, no automatic reconnection of 
¥LCP/DLCP=connected terminal devices will occur. 


tnis system have any communications tyoe devices? i.e., ViP%s, 


TTY’s, etc. 


- Acceptable answers are YES, Y, NO, and N, 


A communications device is an MLOP/OLCrP=connected device. 


If you reply NO, the srogram skips to the prompt. “How many 
40C-connected console devices do you have?", later in this 
dialogue. If you reply YES, you will see the following 
prompts. 


How many communications ortority levels (! to 4) do you wish? Enter 
the number of levels. 


Zach device must be assigned to a hardware interrupt level. 
Nonconmunications devices must be assigned to unique interrupt 
levels: M4 _SYSDir can perform this assignment for you. 


dowever, communications devices can share a oriority level; 


trerefore, you are given a chance to specify relative priority 
levels for each communications device. 


Acceptable answers are I, 2, 3, or 4. If you specify ft, all 
comnunications devices will share one interrupt level. If you 
specify 2 through 4, you will have the capability to assign 
specific devices to different levels, with those devices on 
level | having the highest relative priority and those devices 


On level 4 having the lowest relative ortority. You do not have 


t> assign at least one devide to each levels M4_SYSDEF 
reserves any unused levels for you. 


dow aanu MLCP%s (1 to 19) will this system have? 


° 


411 comnunications devices must be attached to a multiline 
communications processor (MLCP). 


Acceptable answers are ! through 19, inclusive. 


Yow nany ATIs do you nave? 


« 


The prosram is now attempting to configure all MLCr/DLCP 
comnected asynchronous terminal devices. 


The following asynchronous terminal devices are supported: VIP 
7209, VIP 7205, VIP 7801, VIP 7802, Vip 7207, PRUIOO!, PRUIOOS, 
PRUIOOS, TWULOOT, TWUIO0O3, THINS, and various 
teleprinter=compatibl> devices, 


if you reply NONE, the orogram skios to the prompt, “How many 
VIP%s do you have?, below, 


If you renly with a nonzero number, the orngram continues: 
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ATO tarmin3l number N 


» This message, and the three promot following it, aooear N 
times, where N is your resoonse to the earlier question, “How 
nany ATJs do you have?", 


Ahat channel number will tris device be on? 


« (Ou must enter exactly four hexadecimal characters, ending in 
st 30 + or 4 83 “a ‘ 


Snter the communtcations priority level for this terminal. 


« Acceotable answers range from ! through your response to the 
zarlier question, “How nany contunications priority levels (i 
to 4) do you wish?", 


- If you soeclfied only one communications ortority level, this 
oronpt won’t aooear. 


“~ ahat is the Jevice tyoe for this ATD device? 


. (%u must specify one of the followiny values (there {s no 


jJefault): 
Value Physical Device Type ° 
7209 VIP 7203, VIP 7205 
7301 Vie 7801, VIe 7802 
27290 VIP 7207 
Pau PRY 1001, PQUIDO03, PRY 1005, 
TWU 1001, TAUIOO3, TW 1905, 
Tit Can be any asynchronous terminal device-type 
: classified as teleprinter compatible. 
"Yow naay VIP%s do you have? 

« Me Srogram is now attempting to configure synchronous 
terminals. The followtiag synchronous terminals are susosxorted 
oy “44_SYSDEF: 

Vie 7790 

VIP 7700R/VIP 7705R 

VIP 7740 

VIP 7804/VIP 7805 (in VIP 7700 mode) 

. Td use the extended features of the VIP 7804 or Vie 7805, you 
may want to use an STD directive. ST) groups are configured 
later on in the “4_SYSDErF dialog. 

. [f you reply 0, the pragran skios to the sromot, “How many 
43270 siost Links do you have?", below, 

ha 
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. If you reply with a aonzero number, the program continues: 


VIP terminal number N 


ag 
- This messaje, and the seven oronpts following it, appear N 
times, where N is the number you entered in resnonse to the 
earlier question, “How many VIP%s do you have?", 
Nhat channel number will tnis device be on? 
« (Ou must provide the Megabus channel number to which this 
device is attached. 
« You must enter exactly four hexadecinal characters, endina in 
#590" or "80". 
fow many VIP“s are oolled an this channel? 
- ? is not acceptable here. 
« Acceptable answers are the numbers 93 through 31, inclusive. 
ad 


znter the communications ortority level for this terminal. 
- ? is not acceptable here. 
» Acceptable answers range from 1 through your response to the 
earlier question, “How nany communications ortority levels (1 
to 4) Jo you wish?*, 


» [f you speelfiedj only one communications oriority level, this 
pront won’t appear. 


=snter the polling address for this VIP. 


« This promt anoears only If you specified a non-zero value for 
the pronpt “How manu Vie’s are polled On this echannel?", above. 


« Acceotadsle answers are 9 through 31, inclusive, 
Is this VIP 3 "Control Station"? a 

- ? is not acceptable here. 

« Acceptaole answers are YES, Y, NO, or N. 
Joes this VIP have a ROP (receive=Only Printer)? 

e Acceptable answers are YES, Y, NO, or N. 


. If you reply NO, the srogram skios tne next two prompts. If you 
reply YES, the program continues? 
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Ahat type Of ROP do you have? 
- Tnere are eight suovorted ROPs!t 


Devices Supported 


Soecify One (See Appendix C) : 
T1990 TermiNet 100 or PRU 100! 

TN300 (default) TermiNet 300 or PRU 1003 

™ 1200 TermiNet 1200 or PRU 1005 

ait 30 ASR=-33 

TTY35 ASR=35 


Joes this R0P support form feed? 
- 2? fs not accestable here, 
« Acceptable answers are YES, Y, NO, or N. 
“ = dow many H3270 Host Links do you have? 


» The progran is now attempting to configure stations for the 8SC 
3279 line protocol handler in your configuration. 


» Acceptadle answers are 4 nonzero number or NONE. 


» If you reoly NONE, the program skips to the orompt, “How many 
PVE groups do you have?", below. 


» [f you reply with @ nonzero number, the progrant continues? 
43279 line number N 
« This nessages, and the 4 prompts following Lit, anoear N times, 
where N is the number sou entered itn response to the earlier 
question, “How many 43270 Host Links do you »Aave?". 
iy Nhat channel number will this line be on? 


- fou must provide the Megabus channel number to which this iine 
Ls attached. 


» You must enter exactly four hexadecimal characters, ending in 
rf I 30 i) or 20 30 a m 


snter the communications priority level for this line. 
- ? 1s not acceptable here. 


- Acceptable answers ranye from ! through your response to the 
2arlier question, “How many communtcations artority levels (|! 
to 4) Jo you wish?", 


. If you srecified anly xne communications priority level, this 
proapt von’t anpear. 
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Enter the polling address (decimal) for this H3270 Host Link. 

- ? 18 not acceptable here. 

« Acceptable answers ranjye from 0 through 255, tnelusive. 

M4 SYSDEF converts this number to a hexadecimal value for you 
when it defines the H3270 directive. 
Enter the select address (decimal) for this H3270 Host Link. 

e ? is not acceptable here. 

- Acceptable answers range from 0 through 255, inclusive. 
M4_SYSODEF converts this number te a hexadecimal value for you 
when it defines the H3270 directive. 

How many PVE groups do you have? 


« The program is now attempting to build facilities for polled 
VIP emulated (PVE) groups into your configuration. (1) 


. If you reply "“NONE*, the orogram skios to the prompt, “How many 
STO groups do you have ?*, 


« If you reply with a nonzero number, the program continues 
PVE grouo number N 
» This message, and the four orompts following it, appear N 
times, where N is your resoonse to the earlier question, “How 
many PVE groups do you have?". 
Enter channel number for PVE group N 


- ? is not acceotable here. 


« You Must enter exactly four hexadecimal characters, ending [n 
mOOe: ‘or PBO", 


How many PVE stations are there in this channel? 

« ? £8 not acceptable here. 

- Acceptable answers are }) through 32, inclusive. 
Enter the communications priority level for this group. 

- ? fs not secceptable here. 

« Acceptable answers ranje from {| through your response to the 
earlier question, “How many communications priority levels (/j 
to 4) do you wish?*, 

(1) 


A PVE consists of all the PVE stations assigned to the same 
hardware channel. 


« If you specified only one communications oriority level, this 
prompt won’t appear. 


Enter the polling address (0 to 31) for PVE station N 
« 2? ig not acceptable here, 
« Acceptable answers are O through 31, inclusive. 


« The pronpt appears N times, where N is your response to the 
@arlier question, “How many PVE groups do you have?", 


How swnany STD groups do you have? 


» The program is now attempting to configure all MLCP/DLCP 
connected synchronous terminal devices. 


» The following synchronous terminal devices are supporteds VIP 
7804, VIP 7805, Vie 7700, VIP 7790R, VIP 7705R, and VIP 7740. 


- If you reoly NONE, the program skips to the prompt: “How many 


MLCP=connected Binary Synchronous Communications (8SC) lines do 


you have?", below. 
- If you reply with a nonzero number, the program continues: 
STO jrouo number N 


- This message, and the 8 prompts following {t, appear N times, 


where N is your response to the earlier auestion, “How many STD 


groups do you have?", 
Cnter channel number for STD group N 


- You must enter exactly four hexadecimal characters, ending in 
“ Hort or Nao. m 


Enter the communications oriority level for this group 
. Acceptable answers range from {i through your response to the 
sarlier auestion, “How many commuini{cations priority levels (1 
to 4) do you wish?™, 


. [f you spectfied only one communications priority level, this 
oromot won’t anoear. 


tlow Nany STD stations are there On this channel? 

- The reoly "?" is nor acceptable here. 

« Acceptable answers are |! through 32, inclusive. 
Enter the polling address (0 to 31) for STD station N 


- ? £$ ot acceotable here. 
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Nhat 


Acceptable answers are O through 31, inclusive. 


The prompt appears N times, where N is your response to the 
earlier question, “How many STD groups do you have?". 


is the device type for this STD device? 
You must specify One of the following device types: 


Device type Supported Devices 

V7804 VIP 7804, VIP 7805 

V7700 VIP 7700, VIP 7700R, VIP 7705R 
V¥7740 VIP 7760 


this STD have a ROP (Recetiveeonly orinter)? 


If you reply NO, the program skips the next promot. 
If you reply YES, the program continues? 


type of ROP do you have? 


There are four supported ROPss 


Specify One Devices Suvnoorted 
RUSY 24 PRU 1003 

ROSY 25 PRU 1005 

TN390 ' TermiNet 300 
™1200 TermiNnet 1200 


How nany MLCr=cannected Binary Synchronous Communication (BSC) lines 
do you have? 


° 


« 


The program is now attempting to build facilities for BSC lines 
Lato your configuration. 


? is not acceptable here. 


If you reoly O, the program skips to the prompt, "How many 
M9C-connected console devices do you have?", below. 


If you reply with a nonzero number, the program continues? 


BSC line number ¥ 


Nhat 


This message, and the three prompts following it, annear N 
times, where N is your response to the earlier question, “How 
many MLCP=connected 8SC lines do you have?",. 

channel number will this device be on? 

? is not acceptable here. 


You must enter exactly four hexadecimal characters, ending in 
ayOF (“to -"30", 
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Enter the communications prtority leval for this terminal. 
- ? is not accentabie here. 
« Acceptable answers range from |! through your response to the 
earlier question, “How many communications priority levels (1 
to 4) do you wish?*. 


. If you specified only one communications ortority level, this 
2romot won’t apoear. 


Is this 35C line a “Primary” one. 
« ? ts not acceptable here. 
- Accegtadle answers are YES, Y, NO, or N, 
dow nany MIC“conected console devices da you have? 


- Tre orojram is now attempting to build facilities for all 
WiC-connected teminal devices. 


» If you reoly NONE, the orogram skips to the prompt, “How many 
disxettes do you have?”", below, 


» [f you reply with a nonzero number, the orogram continues? 
wON aumber | 
Ahat channel number will tris device be on? 


« Talis prompt appears only if you are exalicitly entering channel 
qumoers, - 


« This oromot anpears N times, where NV is your response to the 
zarlier question, “How many MOC-connected console devices do 
you have?", 


- You must enter exactly four hexadecimal characters, ending in 
#0" or "804, 
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What is the device type for the Operator’s CONSOLE? 
. You must specify one device as the Operator’s temrinal: 


Value : Physical Device Type 
7200 VIP 7200 (DKU9I03) 
VIP 7205 (DKU9! 02) 


Tae value 7200 must be used if MDC~ 
connected VIP 7200 terminals are to 
be used for forms processing using 
the Display Formatting and Control 


facility. 
PRU PRUI0O03/7PRUIOO5/TWUIO03/ THU 1005 
D7290 VIP 7207 
KSR ' The terminal ts to be supported in 


teleprinter mode. 
7803 VIP 7801, VIP 7802 
CON number N 
- This message, and the two oromots following it, appear N = | 
times, where N is your response to the earlier question, “How 
many MOC-connected console devices dO you have?", 
Ahat channel number will this device be on? 


- YOu must enter exactly four hexadecimal characters, ending in 
#00" or "30°, 


- This orommt aopears only if you are explicitly entering channel 
numbers. 


» 2? is not acceotable here. 
What is the device type for this CON device? 


« Specify one of the values oreviously deseribed for CON number 


dow nany diskettes do you have? 
- The program is now attempting to build facilities for diskette 
devices inte your configuration. (See Appendix C for a list of 
diskette device). 


- If you reply O, the oroegram skios to the prompt, "Yow many 
cartridge disks to you have?", below. 


- If you reply with a nonzero number, the orojgram continues? 
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Diskette number N 


Nhat channel number will this device be on? 


This prompt only appears if you are explicitly entering channel 
numbers. 


This promot aopears N times, where N is your response to the 
earlier question, “How many diskettes do you have?", 


? is not acceotable here. 


You must supply exactly four hexadecimal characters, ending in 
*NO" or "20", 


How many cartridge disks do you have? 


a 


« 


The program is now attempting to build facilities for cartridge 
disk devices into your configuration. (See Appendix C for a 
list of cartridge disk devices). 


Your configuration must have at least one cartridge disk, 
cartridge module disk, or mass storage unit. 


[If you reply 0, the program skios to the promot, "Yow many 
cartridje module disks do you have?", below, : 


If you reoly with a s:0nzero number, the orogram continues? 


vartridge Disk number N 


d#hat 


This message, and the two oromots following it. appear N times, 
anere N {fs your response to the earlier question, “How nany 
cartridge disks do you have?"™, 

channel number will this device be an? 


This srompt only appeacs If you are explicitly entering channel 
numbers. 


2 4$ not accentable here. 


fou must suoply exactly four hexadecimal characters, ending in 
ago or Kggu. 


this Catridge Disk have a fixed clatter? 
? £s not acceptable here. 


Acceptable answers are YES, ¥, NO, or N, 
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dow many cartridge module disks do you have? 
e The program is now attempting to build facilities for cartridae 
module disks {nto your configuration. (See Appendix C for a 
list of cartridge module disks). 


- If you reply O, the program skins to the prompt, "How many 
storage Modules do you have?", below, 


- If you reply with a nonzero number, the program continues? 
Catridjge Module Disk Number N 
What channel number will this device be on? 


eo This mromot only anpears if you are explicitly entering channel 
numbers 


e This prompt appears N time, where N is your response to the 
earlier question, “How many cartridge module disks do you 
have ?", 

eo ? ts not acceptable here. 


e You Must supply exactly four hexadecimal characters, ending in 
#90" or “80%, 


How wany storage modules do you have? 
e Tre program is now attempting to build facilities for mass 
storage devices into your configuration. (See Anopendix C for a 
list of mass storage devices). 


- If you reply NONE, the program skips to the orompt, “How many 
card reader/punches do you have?", below, 


« If you reply with a nonzero number, the program continues? 
Storajye YWodule number N 
Nhat channel number will tnis device be on? 


« This prompt only socears if you are explicitly entering channel 
numbers. 


- This prompt appears N times, where N is your response to the 
earlier question, “How many storage modules Jo you have?", 


- ? {8 not acceptable here. 


e You must enter exactly four hexadecimal characters, ending in 
“00° or "80", 
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Yow many card readers do you have? 


The program is now attempting to build facilities for card 
reader devices {nto your configuration. (See Aopendtx C for a 
List of card reader devices). 


If you reply 0, the program skips to the promot, “How many card 
reader/punches or punches do you have?", below. 


if you reply with a nonzero number, the orogram continues! 
Reader number N 
channel number will this device be on? 


This oromot only aopears if you are explicitly extering channel 
numbers. 


This prompt appears N times, where N is your response to the 
garlter question, “How many card readers do you have?*, 


* 


? is not acceotable here. 


You must sunply exactly four hexadecimal characters, ending in 
#90" or "sO", 


How many card reader/pounches or punches do you have? 


o 


The program is now attempting to build facilities for card 
reader/punch devices or card punch devices {nto your 
configuration. Note that “card reader/punch"” doesn’t mean card 
readers Or card punches, but devices that both read and panen. 
cards. (See Anopendix © for a list of card reader/punch 
devices). 


If you reply 9, the program skips to the oromot, “How many 
printers do you have?", below. 


If you reply with a nonzero number, the program continues? 
reader/ounch or punch number N 
channel number will this device be on? 


This sromt only acopears if you are explicitly entering channel 
number s. 


? {s not acceptable here. 

This sromot aopears N times, where N is your response to the 
earlier question, “How many card reader/ounches or punches do 
you have?", 


You must supply exactly four hexadecimal characters, ending in 
490" or “304, 
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How many printers do you have? 
. The program is now attempting to build facilities for line 
printer devices into your configuration. (See Appendix C for a 
list of line printer devices). 


. If you reply O, the program skips to the prompt, “How many 
Yetrack magnetic tape device do you have?", below. 


« If you reply with a nonzero number, the program continues: 
Printer number N 
What channel number will this device be on? 


> This prompt only appears if you are explicitly entering channel 
numbers. 


- This prompt appears N times, where N is your response to the 
earlier question, “How many printers do you have2", 


- ? is not acceptable here. 


« You must supply exactly four hexadecimal characters, ending in 
#004 or NAO. 


How many 9-track magnetic tape devices do you have? 
- The program is now attempting to build facilities for 9% track 
magnetic tape devices {nto your configuration. (See Appendix C 
for a list of 9~track Magnetic tape devices). 


- If you reply 0, the program skins to the prompt "do you wish to 
have ALL system overlays resident (yes or no)?", below. 


« If you reply with a nonzero number, the program continues! 
Magnetie¢é Tape Device number N 
Nhat channel number will this device be on? 


« This prompt only anpears if you are explicitly entering channel 
numbers. 


« This prompt appears N times, where N is your response to the 
@ariiler question, “How many 9 track magnetic tape devices do 
you Rave? 


- ? ts not accentable here. 


« YOu must supply exactly four hexadecimal characters, ending in 
*“00" or "80". 
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Do you wish to have ALL system overlays resident? (yes or no) 


~ - Acceptable answers are YES, Y, NO, or N. 

. If you amswer yes, the system optimizes the execution speed of 
all functionsst the resulting system will occupy more memory 
than a system without resident overlays. The program skins to 
the prompt, “Do you wish to create a batch memory pool?". 

- [If you answer no, the program continues?! 

Yo you wish to ootimize the reading/writing Of relative files? 

« dy Making particular system input/output overlays permanently 
resident, you can obtain optimum soeed for selected file types. 
This oromot, and the six that follow, ask if you wish to 
ootimize the execution soeed necessary to perform different 
functions. 

- Acceptable answers are YES, Y, NO, or N. 

ae ° 
Do you wish to ootimize the reading/writing of random files? 

- Acceptable answers are YES, Y, NO, or N. 

Jo you wish to optimize the reading/writing of tndexed files? 

. Acceptable answers are YES, Y, NO, or N. 

Do you wish to optimize releative files with deletable records? 

« Acceptable answers are YES, Y, NO, or N. 

Yo you wish to optimize file management onen/close functions? 

- Acceptable answers are YES, Y, NO, or N. 

Do you wish to ootimize the reading/writing of tape files? 
ww » Acceptable answers are YES, Y, NO, or N. 
- This prompt appears only if you oreviously specified that your 
system suvooorts magnetic tape devices. 
Do you wish to optimize SBCDIC tape functions? 
e Acceptable answers are YES, Y, NO, or N. » 
JO you wish to create a batch memory pool? 

. Acceptable answers are YES, Y, NO, or N. 

- If you answer no, the srogram skios to the prompt, “Enter the 
number (1 to 10) of 320-word system overlay areas you desire", 
nelow. If you answer yes, the orogram continues? 

we 
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How big a batch pool? (nnnnn or nnk words) 
» Nonnumeric characters (except for “k") are not acceptable here. 
» YOu must supply a numeric value of the form nannn or nnk words 
Enter the number (I to 99) of system overlay areas you desire, 
» Nonnumeric characters are unacceotable here. 


e The number of system Overlays that you specify will be loaded 
{nto the system area Of memory where they will remain resident 
for the duration of the configured system. The larger the 
number of system overlays is, the more likely it is that 
frequently used system Overlays will be found in memory. 


Would you like to see the generated statements? 
« Acceptable answers are YES, Y, NO, or N. 


« If you answer yes, M4_SYSDEF lists the contents of the file of 
CLM directives it has generated for you. At the top of the 
listing (below the SYS directive statement) the program 
identifies for you the version of M4_SYSDEF that you are using, 
as well as the date and time that your CLM directive file was 
generated. 


e If you spot an error at this point, you can enter rebuild mode 
by ALtting the break key and then typing the command PI 
(orogram interruot). See "M4_SYSDEr Dialog In Rebuild Mode* 
later in. this section. 


« [f you answer no, the program continues? 
Do you want to create a CLM directive file now? 
e Acceptable answers are YES, Y, NO, or Ne 


« If you reply no to both this question and the preceding 
question, the program warns you that the directives will he 
lest and processing will terminate, and asks if this is what 
you intend. If you reply yes, this is what you intend, 
processing terminates, and no directive file is created. If you 
reply no, the previous question, "Would you like to see the 
generated statements?", is repeated. 


- [f you reply no to this auestion Dut replied yes to the 
preceding question, processing terminates. 
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ee 


{f you reply yes, the M4_SYSDEF program automatically generates 
a map file for you containing configuration information you may 
find useful. (For a complete exolanation of the map file, refer 
to the deseriotion of the MAP directive {n Section V). The 
program assigns this map file the pathname >SID>CLM_MAP, [f you 
wish to examine CLM_MAP after you create your CLM file, you can 
use a print (PR) command or invoke the Editor and use the 
Zditor’s read and print directives. 


If you reply yes, the srogram continues? 5 


Nould you like to use a file name other than CLM_USER for this file? 


* 


Acceptable answers are YES, Y, NO, or N. 


You may wish to use the default file name CLM_USER or a file 
name Of your own. If you answer no, M4_SYSDEF creates CLM_USER 
under your current working directory SID and processing 
terminates. 


If this file already exists in your current. working directory, 
M4_SYSDEF tnforms you and gives you the option of quitting, 
remwritting the file, or providing another file name. 


Note that although you are free to rename your CLM file, the 
system must be able to locate a file named CLM_LUSER under 
directory SID at system startuo. Remaining your CLM file allows 
you the option of creating nore CLM files than just the one 
your system needs at configuration time. You may, for examole, 
be creating CLM files for several installations. in which case 
you May want each one to have a unique name for identification 
purposes. i oe ; 24 


If you answer yes, the program continues: 


Enter your filename —=— 


* 


The file aame you choose must be no longer than [2-characters 
and must conform to standard file name conventions, 


After you enter your file name, M4_SYYSDEF creates your CLM 
fil? under your working directory SIO, and processing 
terminates. The program lists the full pathnames of the CLM 
file a. its corresponding restart file at your terminal. If, 
at some later time you wish to modify your CLM file, see "Using 
M4_SYSDEF tn Rebuild Mode", earlier in this section. 


If this file already exists in your current working directory, 


M4_SYSDEF informs you and gives you the option of quitting, 
re-writing the file, or providing another file name. 
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M4_SYSDEF OIALOG IN REBUILD MODE 


nee you invoke M4_SYSDEF and specify the pathname of a restart 


file, the program responds with: You 
rebuild mode. Do you want to see the 


have entered M4_SYSDEF in the 
existing CLM statements? 


« If you respond YES, the program lists the CLM directives 
conteined in your restart file. 


« If you respond NO, the orogram continues # . 


Do you wish to modify devices or system parameters? 
Respond with "SYSTEM", “DEVICES", “VIEW®, or #“DONE*, 


Response ® 


» Depending on your resoonse, 


described earlier in this section. 


the orogram will enter the 
“4_SYSDEF dialog at the appropriate place so you can make 
nodifications. Table 4-1] lists each question and response in 
the rebuild mode dialog. The complate M4_SYSDEF dialog ts 


- If you respond SYSTEM, the program asks the question, "Do you 
wish to modify the prompt (PROMPT), memory size (MEMORY), the 
number of interactive users (USERS), the automatic jgeneration 


of SPD names (SPD), the automatic channel assignment (CHANNEL), 


the record locking feature (RLOCK), the system overlay areas 


(SOAT), the resident overlays (RESOLA), the display formatting 


feature (VDAM), the commercial or SIP simulators (SIMUL), or 
the system and installation identification (IDENT)? Depending 


on your response to this auestion, 


the program will enter the 


M4_SYSDEF dialog at the appropriate place so you can make 
modifications. Once you have finished making your 
modifications, enter the reoly IONE. 


« If you respond DEVICES, the program asks the question, “Respond 
with the device type or class that you wish to modify. "COMM", 
YOON, "DSK", #RCD4, 1MSM4 aCMD4, “COR”, 4CRP#, #LpT, “MTP, 


er “DONE”. Deoending on your response to this question, the 
program will enter the M4_SYSDEr dialog at the appropriate 
olace so you can make todifications. If you reply DONE, the 


orogram will repeat the prompt, “Do you wish to modify devices 


or system parameters?" When you have finished making your 
modifications, enter the reply DONE. 


. If you reply VIEW, the program lists the current CLM file at 


your terminal. 


e If you reply DONE, the program skips through the M4_SYSDEF 
dtialoj to the promot, “Would you like to see the generated 
statements?" Normal M4_SYSDEF termination vrompts follow, 
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. Ahen M4_SYSDEF processing terminates normally, the program will 
list the oathnames of your CLM directive file and tts 
associated restart file. If you wish to modify this CLM file at 
some Later time, you invoke M4_SYSDEF, specifying the pathname 
of this restart file on the command line. 


Table 4~i lists each question and response in the rebuild mode 
dialog. Using this table, you can trace each of your possible 
resoonses tO a specific entry point in the M4_SYSDEF program dialog. 


To use this table, begin in the Left hand column and read across to 
the right. Note that the questions you are required to answer become 
tore specific as you isolate the specific section of the M4_SYSDEF 
dialoz that you wish to enter. The fifth column lists the actual 
questions in the M4_SYSDEF program dialog that anvear as a result of 
your response to previous rebuild mode questions. Column six lists 
the pages in this section of the manual that explain each M4_SYSDEF 
question in detail. 
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EXAMPLES OF M4_SYSDEF USAG= 


The following exammoles illustrate how you can first create a CLY¥ 
directive file and then modify it at some later time by invoking 
M4_SYSDEF in rebuilt mode. Example | steps through the entire 

M4_SYSDEF dialog. Example 2 {llustrates the rebuild mode dialog. 


Example 1/3 
POllowing a Stage i (initial) system startup, a new user wishes to 
create a CLM file using M4_SYSDEF. Prior to invoking M4_SYSDEF, the 
user must transfer control of the operator’s terminal from the $S 
(system) task group to the supolied user task group $Hs 
4C 4 tSH2% 
The terminal is now under control of the SH task grouo. The user 
wishes to see the ready prompt message, and so enters the RDN (ready 
on) command: 
RON See 
The system responds? 
(SH )RDY # 


The user invokes M4 SYSDEF and defines a CLM filet 
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i wee 
Ma_SYSOEF : : 

HELLO$ THIS TOOL WIth HELP YOU GENERATE THE FILE CUNTAINING 

THE CONFIGUWATION LUAD MANAGER OIRECTIVES (THE CLM_USER FILE). 
WHICH IS NECESSAXY 70 BUILD YOUR GCOS6/M00G00 OPERATING SYSTEM, : 
ON yvOU WISH TO USE TRE LUNG PROMPI MODE? ; 

7 


THERE a@& FWO MODES IN wHICHM TU RUN THIS TOOL, THE LUNG 

MODE aND THe SHOWT MUDE. IF YOU KICK THE LONG MODE, EVERY PRUMPT 
MESSAGE WiLL #E PRECEDED BY AN EXPLANGSTION UF WHAT [ME WEQUESTEY 
INFORMATION 1S, sRERE YUU CaN FIND THE REQUESTED INFURMATIOUN, ANDO 


w4aT WILL HAPPEN JF YUU SUPPLY CERTAIN INFORMATION, THE SHURT MUOE SHUULO 


BE USED BY PERSONS wRU HAVE BUILT THIS SYSTEM bEFURE &ND DOU NUT NEED 
THE LONG PROMPT Text. IF YOU SELECT THe SHORT MODE AND THEN FINO 
THaT YilU NEED HELY LN ANSWERING Ove GF FME QUESTIONS, YUU Can OUTALN 
THE LOWG MONE TEx! GY EVTERING & '2'3 THES WILL NUT CHANGE TRE MULE 
AND ALL SUBSEQUENT QLESTIUNS WILL BE UF THE SHURT FuURM, 

SINCE THIS [3S & GENERALIZED TUQL, CERTAIN CUMMON DEP OULTS HAVE BEEN 
ASSUMED; IF YUUR SYSTEM REGUIRES A CHANGE TO THESE UCFAULTS, YUU CaN 
GENERATE Tee *CLM_LUSERT FILE AND IREN USE THE STANOSkO tO TUR 

Th MAME THESE MOUIFIC&TIONS, GUCD LUCK, 

08 YOUU wlSe TU USt THE LUNG PRUMP! MODE? 

YES 


THE TUTSL *MUUNT UF WEAL, PRYSTCAL MEMURY INSTALLEU UN THE MACHINE 
FUR we{Cr TRIS SYSTEM TS BEING BULLY “AY BE OT FRERENT Frum 
THE MEMOWY BYVATLABLE UN THE MACHINE YOU ARE CUKWENTLY USING, 
THE MINIMUM CUNFIGUMATION FOR GCOsesMOUS00 [S *‘4an’' wuRDdDS, , 
wHaT [5 Tre TOTAL AMUUNT (CIN WORDS) OF RESL MEMURY UN THE MACHINE TRIS 
SYSTEM IS Tu HUN UN? ENTER FRE VALUE’ IN THE FORM? WN, 

128K 


IF YOU alsh, we CaN GENERATE THE CUM OIRECTIVeES mifPuut sPeciFrINy 
THE CHANNEL NUMRENS FUR NOINOCOMMUNICATIUN TYPE DEVICES, FUN 
COMMUNICATION DEVICES YOU MYST ALWAYS PRUVIDE A CHANNEL NUMBER, 

AY SYSTEM STanfeout Time, TRE SYSTEM awILL POLL Tae HakUKaRe AND 
DETERMINE YRIN WHICH CeANNEL EACH DEVICE [§ LOCATEL. i 
00 YUU wISh The SYSTEM TU SUPPLY INE CHANNEL NUMGEWS FUR 
NUN@*COMMYUN[CAT ION OE VICES? 

WO 


ENTER THE CRANNEL NUMBER UF TRE UPERATOR TERMINAL 
WHICH wIth BE Trek CUNSHLE 


0400 
ENTER THe CHANNEL NUMBER UF TRE SLOT DEVICE 
1400 
CO YUU wlSe fO BUUT THE FIXED PLal TER? 
NY 


Figure 41. Using M4_SYSDEF 
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A COMMERCIAL SYSTEM IS A MODEL &/ OR MUDEL 57. 
TS THIS A CUMMERCTAL SYSTEM? REPLY "YES" OR "NUL" 


N 

SINCE YOU OO NOT HAVE & COMMERCIAL SYSTEM, WILL YOU 
HAVE THE COMMERCIAL SIMULATOR? IF YOU REPLY ‘NU’, THEN 
PRIS SYSTEM WILL NOT BE ABLE TO SUPPORT COBOL. 

WILL THIS SYSTEM HAVE A COMMERCIAL SIMULATOR? 

¥ 


SIP MEANS'SCIENTIFIC INSTRUCTION PROCESSOR’. 
WILL THIS SYSTEM maVE A SIP? REPLY *¥YES* OR "NUL? 
N 


SINCE YOU DU NOT M4VE TRE "SCIENTIFIC INSTRUCTILUN PHUCESSUR', WILL YUU 
MAVE THE SIMULATOR FOR THIS HAROWAWE OPTION? IP YUU REPLY 'NU!, IREN 
THIS SYSTEM WILL NOT BSE ABLE TU SuPPORT ANY GF TRE SCIENTIFIC 
INSTRUCTIONS. 

WILL THES SYSTEM HAVE A SIMULATUR FOR THE SIP? REFLY "YES" Um *NU,* 
YES 

DO YOU WANT [FRE DOUBLE PRECISION SImuLATOR SIPSIM? 

NO 


THE SYSTEM IDENTIFICATION I$ UNE UF THE STANDARD PARTS tik TmE CUMMENT 
STATEMENTS THIS UTELITY AUTOMATICALLY GENERATES, 
IF YGU ENTER & NEw VALUE MAKE SURE £7 IS ENCLOSED wiTHIN 
APQSTROPHE MARKS UR SUME GF THE INFORMAIIUN MAY SE LUST, 
THE VEFAULT SYSTEM IVENTIFICATION I$ 'GCOSesmMovauy', 
IF YGU WISH TU CHANGE IT, MEPLY "rests [F Yuu UU NUIT wisH TU 
CHANGE I[1, REPLY ‘NUT. DU YOU? : 
¥ 
ENTER THE Neb SYSTEM LOENTIFICATIUN (30 CHARACTERS Un LESS) [N Fae PURM? 
'SYSTEM_IDENTIFICATION® 
'GCOSe6/MU0 400 VERSION 2.1' 


THE INSTALLATION JOENTIFICATION 18S UNE UP TRE STANUARL PARIS UF Trt 
COMMENT STATEMENTS THIS UTILITY suTOMaTICALLY Gentkales, 

IF YOU ENTER 4&4 NEW VALUE, MAKE SURE FY IS ENCLUSED 
WITHIN APUSTRUPHr MARKS Om SOME Ge THRE INFORMATIUN MAY aéE LUSI, 
THE DEFAULT INST4L LATION IVENTIFILATIMN IS "YOUR TUAW, Sal, 

IF yOu wilSm TU CHANGE IT, REPLY *TeS*3s JF YOU VU NU! alse To 
CHANGE IT, HEPLY ‘NU’. O00 YOU? 

YES 
ENTER TRE New ENSTALLATION IDENTI¢F loatTiun (30 CHAwRALIERS Um Ledso) 
IN THE FORMS "INSTALL ATIUN IO! 

'TEST SIT& UNE 


TRE NUMBER DF CUNCURRENT USERS A255ISTS IN Trt CALCULATION UF SYSTEM 
STRUE TURE SIZES ANDO MEMORY NEEDS wettw vaky VEPENOING 
UPON THE MAXIMUM LUAD THE SYSTEM LS TO SE CUNF lLOUmEL 
FOR, TMERE IS, HUWEVEN, NO wAY TU ENSURE Teal TRE aX] MUM 
. NUMBER OF USERS THaT YUU SPECIFY Here WILL INDERU 


Figure 4<1 (Cont). Using: M4_SYSDEF 


4=34 


BE THE MAX, NUMBER UF USERS THE SYSTEM wILL SuUPPURT, THIS DEPENDS 
ON SUCM DYNAMIC VARIABLES 49 THE AORK EACH USER IS PERFURMING, ANU 
MEMORY FRAUMENTAI[UN, 

PLEASE ENTER THE MAXIMUM NUMBER Or CONCURRENT USERS THAT YUU 
EXPECT THES SYSTEM TU SUPPORT, 

by 


EVERY PERLPMERAL DEVICE ATTACHED Tu PRIS SYSTEM MUST RAVE & 

SPO (SYMBOLIC PENT PrHeERAaL DEVICE) VAmMeE, THIS Name [5 & 

UNIQUE & CHAWACTER (MAXIMUM) NAME wel CK CUNFORMS TO THE FILE SYSTEM 
NAMING CONVENTIONS. LF YUU REPLY 'YES' MERE, 1 RILEL GENERATE THESE 
NAMES FOR YUU wITRUUT ANY FURTHER PROMPTS, 1F YUU NEPLY "Nol, JT wih 
ASK YOU TU SUPPLY Tee SPD NAME FUN EaCR AND EVERY DevVICe ad we 
CONF IGuRe THAT OeVICt 

SHOULD [ AUIUMATICALLY GENERATE Tht SPO NAMES FUR TOU? 

Y : 


RECORD LUCKING [5S Tht FINEST GRANULARITY OF CUNCURRENCY CUNTHOL Treat 
NOTA MENAGEMENT PRUVICES, ACTIVAIIUN OF TRIS RUN@F ime UPTIUN PHOVIVES 
TOOLS 19 a@LLuw mone ThAN ONE USER TQ wRITE HECUNOS TU a GlVtN PILE aT 
THE SAME TIME, PRUPER USAGE GF THIS OPTION INSURES THAT ALL UPDATES 
ARE CORRECTLY 49nL ito fl THE FILE. IF YOU HEPLY "YES", THIS UPTIUN WiLL 
BE AVAILABLE. [F YUU KEPLY "NU", (REN DATA MANAGEMENT WELL ENFORCE 
FILE LEVEL CUNC'JewENCY, L.&,. GNLY UNE USER WITH WRIJb PeeMiSSION TO & FILE. 
DO YOU slSe THIS SYSTEM TY ACTIVAIE THE RECURD LUCALING FEATURE UP 
DATA MANAGEIEART ? . 
YES 


IF YOU Art PLANNING TU USE Fre OLSPLAY FURMATTING aN CUNTRUL 
SOF TwANe we NEED TU Kantw SU IT Cae BE [INCLUDED In THE SYSiEM, 
NO Yiiy alSe Tu EvCLUGe PISPLAY FURMAaTTING aN CUNTRUL SIF leanne 7 
Yes 


DU YOu wlSH Tu ACTIVATE TRE POWER FAIL RESTAWT ¢ 
YES 


QUES TRIS SYSTE” Have ANY CUOMMUNICATIUWS TYPE veEVICes? 

lebeeo VIPSe TIVYS, BIC. 

YES 

EVERY vevice MUST HE S2SSIGNED TO 4 HAROWAKE INTERRUPT LeveL, 

WE WILL Plo Tee aABSOLUTe VaLUE FUR ALL DEVICES, SINCe [wey muUST 
(WETR ONE EXCePTIUN) BE UNTQUE, CUMMUNICATIUNS UVEVICES,. RUWEVER, 
MAY SMSRke HARM WATE LOVELS AND THUD TO FACIE ate The ASSLENMENT 
YOU MUST PMIVIDE & WeLa@l ive LEVEL FUR EACH CUMMUNICATION UeVICe 
CONF [GuURE}). THE sNSweR TU THE Next QuESTION awlil 
SET yP Tee 44NGE UF LevelLS YOU wIoM Tt} HAVE, Tee ACCEPTABLE values 
ARes te2e5e%, TR YUU SPECIFY 1, 'HEN ALL COMMUNICATION DEVICES 
WILL @& UN HE S4ME RARDWARE LEVEL. IF YOU SPECIFY 3,6 teen Vid 
aAILL s4ve THE QPPURTUNITY 10 SPRE&L THF COMMUMLCATIUN DEVICES 
QVER 3 Separate LeEVvVets (3. 26 3), WITH TMUSE O&VICES UN LEVEL 


Figure 4—1 (Cont). Using 44_SYSDEF 


4=35 


—_— Pa wee oe at ee 


1 MAVING THE MIGHEST PRIORITY ANDO THOSE ON LEVEL 3 THE Lorest. 
HOW MANY COMMUNICATIGN PRIURITY LEVELS (1 FO @) 0 Yuu wySa? 
ENTER THE NUMBER UF LEVELS, 

r-) 

ALL COMMUNICATION TYPE DEVICES MUST BE ATTACHED TU A MULTIEL INE 
COMMUNICATIUNS PRUCESSOR (MLCP), 

HOW MANY MLEPS (1 TU 10} WILL THIS SYSTEM HAVE? 

a 


WE ARE REAUY TO CUNFIGURE ANY MLCP CONNECTED 4S5YNCHnURUUS TeEeM [eal 
DEVICES (ATO) THAT YOU HAVE, THESE INCLUDE TRE 7200 RUN IM TELEPRINTER 
MODE 4ND ALL OTHER aTOS, [rh YOU OU NOT MAVE ONY UF THESE VEVICES Tu 
CONFIGURE REPLY "NONE" TO THE FULLUWING QUESTIUN, 

HOW MANY ATUS DO YUU Have? 
2 


47D TERMINAL NUMBER t 
YOU NEEM TO PROVIVE THE BUS CHANNEL NUMBER 10 aeiCm ERIS DEVICE 
HAS BEEN ATTACHED, THE CHANNEL NUMBER [5 & UNTUUE bUUH CHARACTER 
HEXACECIMaL valLUe welCH ENDS wITH EYTHER "OO" UN *“eU"%, 
YOU MUST EnsTEK EXACTLY FUUR CHARACTERS, 
WHAT CHANNEL NUMBER WILL THIS DEVICE BE ON? 
FO&0 
ENTER TRE CUMMUNICATIUNS PRIORITY LEVEL FUR THIS TERMINAL 
2 
HEVICE TYPES SUPPURTED wY THE ASYNCHRONUUS TERMINGAL VEVICE DRIVER [NCLUDE 
TTY, FANO, 7F7O01, O7A200 AND PRU, 
WHAT IS THE DEVICE TYPE FOR THIS aTO DEVICE? 
TTY 


ATD TERMINAL NUMBER 2 
WHAT CHANNEL NUMMER WILL THIS DEVICE BE ON? 
FC00 
ENTER THE CUMMUNICATIUNS PRIGRITY LEVEL FUR TH1S TERMINAL 
3 
WHAT TS THE DEVEiCe TYPE FUR THIS 4TD DEvICE? 
7804 


WE ARE NOw READY TU CONFIGURE THE VIPT7T0US OR VIPTBUES WRHICR 

ARE TO BE RUN IN VIP7700 EMULATION MUDE. IF YUU DY NUT WAVE any 
VIPS TO CUNFIGURE. REPLY ‘NONE TU THE FOLLUAING QuesiiuUN, 

HOW MANY VIPS DU YUU Have? 

3 


VEP TERMINAL WUMPER 1 
WHAT CHANNEL NUMMER WILL THIS GEVICE Bt ON? - 
FFOO 
HOw MANY VIPS ARE PULLED (CIN THIS CHANNEL? 
9 


Figure 4=1 (Cont). Using M4_SYSDEF 


ENTER Fre CUMMUNICATIUNS PRIORITY LEVEL FUR THIS TERMINAL 

is THIS Vie & "CunTwuL STATION’? 

AGEs THIS VIP HAVE & ROP (RECEIVE UNLY PRINTER)? 

reve AWE 5 TYPES UP HUMES TTYS3, iTy55+ TNIOU, FNSGU, AND TNIgUY, 
WHAT TYPE ve RUP QU YUU have? 


ING200 r. 
QOES THIS wUP SUPPURT FORM FEED? i 
YES 
VIP TENH{INAL NUMBER 2 
AMAT Caaheh MUMGER ALLL THIS DEVICE HE UN? 
FFBO 
HOw MANY vires Bet PULLED UN THIS VLHANNEL? 
NONE P 


ENTER THE CUPMUNICATIUNS PWLURITY LEVEL FOR TRIS Terminal 
3 

1S Te[S vIP & Cute. STallUuN'? 

N 

QOES THIS vEP Have A RUPP (RECEIVE UNLY PRINTER) & 

is 


VIP TeRMivat NUMMER 3 
wMAT CHANNEL WUMBER AILL THIS DEVICE §& UN? 
FEOO 


4m MAawY ViPS ARE PULLEN JN THIS GCHaNNEL? : 2 


1 

ENTER Tre CumMUNICATIUNS PRIORITY LEVEL FUR TRIS TERMLival 
2 

ENTER Tee POLLING AUDRESS FOR THIa yvIP 


BOES TRIS vIP wAVE & WUP (RECEIVE UNLY PRINTER) ¢ 


WE AWE Nilw NE ADY FO CUNFIGURE TRE 4$270 MUST LINAS AmICH ake TH 

BE RUN BY Tet SSC LINE BPROIJTOCUL HANDLER, IF YUU OU WUT Save ANY 
M327TO BST ULieaS 11) COWF(GURE, REPLY NUNE TU Tre FULLUMING uvesrlun, 
WOw Mayy “S270 HUST LINKS Ul YOU +&yE? 

é 


R3270 Liwe suMder 1 

ARAT CRANKEL KUMSER WILL THIS LING BE UN? 

3 

YOU NEEN Tu PRUVIive Tre BUS CHANNEL NUMBER TO we{Cr InITS YEVICE 
M&S Recev alTaCcmeb., Tre CRANNEL NUMBER [3 & UNIUUS FUUR Craeacten 
HEXADECT MAL VALU wet Cr eNOS AIT EITHER "90% YR *eu", 

YOU MUST Rvlew EXACTLY POUM CHARAL TENS, 
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WHAT CHANKEL NUMBER WILL THIS LINE BE UN? 
Fabo 
ENTER The CUMMUNICATIUNS PRIORITY LeveL FOR THIS LIne 


4 

ENTER FRE PULLING ADVORESS (DECIMAL) FUR THIS 4S$€70 nUST LINK 
i23 

ee THE SELECT AVORESS (VEECIMAL) FOR TRIS HSe?%uU MUST Lina 
23a 


#3270 LIKE NUMREX e 
WHAT CRAMNEL NUMBER ILL TRIS LING BE ON? 
F800 


ENTER THe CUMMUNICATIUNS PRIORITY LeveL FUR THIS Line 


2 

oa THE PULLING SO00UNESS (DECIMAL) File Trtl> MS270 RUST LINA 
124 

ie i FME SELECT AOURESS (DECIMAL) FUR THIS HSE70 HUST LINK 


wE ORE NOK WEADY 11) CUNFIGURE The PULLED VIF EauLaluRm levee) SeUulLes 

(4 PVE GRUUP CONSISTS UF ALL THE PVE STOP LUNS aSSTuhen TO Tet Samet 
HARDWARE CHANNEL). Tr YUU OO NUT Have any PVE STATIUNS TU Cuter Luunr, 
REPLY "NUNE” 10 TRE FULLURING GUESTIUN. 

MOe ManwY PVE GRUUPS OU Yu RAVE? 

2 


PVE GROUP NUMBER 1 
ENTER CHSNNEL NUMBER FOR PVE 
F996 


BRUUrY t 


HOw mMaWwyY PVE STATIUNS 48 THe RE Ut FATS 
2 
ENTER THe CUMMUNICATIUOWS PeFORITY LEVEL 
2 
ENTE THE PULLING ADDRESS (0 TO 31) FUR 


1 
ENTER THe PULLING AUORESS (6 FU $3) FUR 
é 

PVE GROUP NURGES 2 
ENTER Chadwell WietheENW FUR PVE GRUUP 2 
F980 
MON MANY Pye STATIUNS Awe THERE Uv TRIS 
3 

ENTER THE CUMMUNICATIUNS PRIORITY LEVEL 
4 
ENTER THE PULLING ANDRESS (0 TU $1) FuR 


1 
ENTER Tee POLL Ine ANOWESS (6 TU 31) Fie 
é 
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Crannwet ? 
FUR THIS wHliue 
PVE STal lus 


PVe stariun 


CHaaNeL ¢ 
Fur telS Geuur 
PVE ST&aT lun 


PVE STariun 


(Cont). Using M4_SYSDEF 


ENTER Tre PULLING 400RESS (O TO $1) FOR PVE STATION $ 
3 


nE—E ARE NOW READY FU CONFIGURE THE SYNCHRUNQUS TERMINAL DEVICE (STU) 
GROUPS (4 STO teuuUP CUNSISTS UF ALL THE STO STATIUNS ASSIGNED TU THE 
SAME HARDWORE CHANNEL). TRE PULLING SEQUENCE WITHIN A GRUUP LS 
DETFRMINGeV #Y Tee URUER ENTERED, 

TF YOu OG NUT Have ANY STO STATLUNS TO CUNFIGURE, 
REPLY "NONE* TO THE FULLOCWING QUESTION, 

wOW MANY STD GROUPS YO TOU RAVE? 

2 


STD GROUP NUMREA t 
ENTER CrA&NNeL Nuwsee PUN STD BRUUP t 
F680 
ENTER TRE CUMMUNICAIIONS PRIURITY LEVEL FUR TRIS GRUUP 
3 
HOW M&yY STU STAILTUWS 4hE— THERE Ov THLS CHANNEL? 


2 

ENTER TRE PULLING S00RESS (0 TU 31} FUR STO STATION 1 aa 

23 
DEVICE TYPES SUPPURTED BY TRE SYNC RRUNOUS TERMI WAL UtVICE Dal ver 
INCLUNe V7IANG, VITVO ANDO V7766 

wheat [5S Tre VEvice TYPE FOm Ted SIO OEVICE? 

¥v780¢0 

DOES THIS STO Have A RUP (RECEIVE Unhr PRINTER} 2 

YES 

THERE ARE @ FYPES UF ROPS WOSY2u, KUSY2m.e TNSOU, aw TNI2UO, 
aeaTyT TYPE UF rUP DU YUU RAVE? 


* 


IN300 

ENTER Tre PULLIN SuUKESS (0 TU 31) FUR SID STAFIUN é 
24 

WHAT [5 TmE Device Tree FOR THIS STO DEVICE? 

¥7804 


“NUES TH{S STG Have & KUP (RECEIVE UNLY PRINTER) ? 
Y 

weaT TYPe UF kUP UU TUU R4aVE? 

TNSO90 


STO GRUUP HWUMBE é 
ENTER CHANNEL Nttbenw FUR $ID GkODUP 2 
Fedo 
ENTER TRE CUMMYNICATIUNS PRIURITY LEVEL FUR [RIS GauUF 
4 
HOn Mahy STU STATIUNS A4RE THERE UV THIS CHOMNELS | Bs 


3 

ENTER THE PULLING SADURESS (oO TO 31) Fuk STO STAT LUN 3 
23 

WHAT IS Teh VevICkh TYPR FoR TRIS afy HEvice? 
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VT700 
DGES TRIS S$fb WAVE A ROP (RECEIVE UNLY PRINTER) ¢ 
YES 
whAT TYPE OF ROP OU YUU have? 
TN1E200 
ENTER THE POLLING ADDRESS (0 TU 31) FOR STO STATION a 
24 
WHAT I$ Tre DeVICe TYPE FOR TRIS STO DEVICE? 
vV7706 
COES TrlS SID HAvE & ROP CRECEIVE UNLY PRINTER)? 
NO 
ENTER THE PULLING ADORESS (6 TO $13 Fuk STD STarluk 5 
es 
WHAT IS THE DEVICE TYPE FOR THIS STD DEVICE? 
V7706 
DOES THIS STD MAVE & RUP (RECEIVE UNLY PRINTERI? 
YES 
wHAT TYPE OF KOP DU YOU R4&aVE? 
TNL 200 
— 
40m MANY MLCOP COMWECTEO BINARY SY YCHRUNUUS COMMUNICATIUNS (350) LENeSs 
uO YOU Have? 
2 
@SC LING NUMBER i 
WHAT CreannelL NUMBER WILL TRIS DEVICE BE UN? 
F000 
ENTER THE CUMMUNICATIUNS PRIORITY LEVEL FUR FHIS TERM lial 
1 
IS THIS GSC LINE & Pei MARY! ONE? 
YES 
BSC LINE NURGER 2 
WHAT CHANNEL NUMBEK WILL THIS DEVICE BE ONY 
F086 . 
ENTER Tre CUMMUNICSI LUNS PRIORITY LEVEL FUR ImIS Te xminNaL 
1 
IS THIS BSE LINE & “PRIMARY® UNE? 
NG 
/ 
WE AWE NOw MERDY TU CuNFIGURE ALL MOC CUNNECTEL CUNSULE VeviILes. 
THESE CUNSOLeE DEVIEeS 496 ALL RANULED BY THe CUNSULE NevIce 
ORIVER (CON), LF YUU UG NUT RAVE Ay TU CUNFIGURE, XEPLY 
*“NONE* TO THE FOLLUWING GUESTION, 
HOW MANY MDC CONNECTED CUNSOLE DEVICES DU YUU nave? 
2 ‘ 
CGN NUMBER 1 
Figure 4=i (Cont). Using M4_SYSDEF 
~— 
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WHAT CHANNEL NUMBER WILL THIS DEVICE BE ON? 
0900 

OEVICE TYPES SUPPURTED BY THE CUNDSULE CEVICE ORIVER INCLUDE 
KSR, 7200, 7801, V720U AND PRU, 

wHaAT I$ THE OC&EVICE TYPE FUR THE UrERATUR'S CUNSOLE? 

KSR 


CON NUMBER 2 
AMAT CHANNEL NUMBER WILL THIS OEVICE ge ON? 
694u 

WHAT [S$ THe DEVICE FYPE FOR THIS CON DEVICE? 
7801 


WE ARE NOW Re aDY TU CONFIGURE ALL DISKETTE DEVICES. IF 
YOU OO NOT WAVE ANY OLSKETTE VEVIVES, REPLY ‘NONE’ FU Tre 
FOLLOWING QUESTIVUIN, 

HOw MANY UISKEPTES OU YOU HAVE? 
a 


DISKETTE NUMBER t 
WHAT CHANNEL NUMBER WILL TRIS CEVICE BE UN? ‘ 


0500 

OISKETTE wummer é 

WHAT CHANNEL NUMHEH WILL THIS VEVICE BE ON7 > 

0$80 

CISKETTE NUMBER 3 
weHAT CHANNEL NUMBER WILL TRIS OFVICE HE UN? : B. _ 
1200 


OISKETTE NUMBER a 
WHAT CrawheL NUMBER WILt TIS DEVICE BE UN? : 
1280 


WE ARE NOw ek anyY TU CONFIGURE ALL CARTRIUGE 115K 
DEVICES. IF YOU vu NOT Have ANY TU CUNFIGURE, KEPLY 'NUNE' TY THE 
FOLLOWING WUESTIUN, 

HOW MANY CaRTRIOGE DISKS DU YUU Have? 


2 

~ + - 
CARTRIOGE UISK NUMBER 1 ; 
wHaAT CHANNEL NUMMER WILL THIS DevICE Be UN? 
1400 . 
QUES THIS COWTRIUGE VISR WAVE & FLXED PLATTER? i 
YES 7 
CARTRIDGE VISK “UMBER 2 io os 
wMAT CHANNEL NUMBER WILL THIS Device He UN? 
146% 7 


Figure 4<i (Cont). Using M4_SYSDEF 
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DOES THIS CANTRIUGE DISK HAVE A FAXED PLATTER? 
nO 


WE ARE NOW REAGY TU CONFIGURE ALL CaRFRIDGE MUDULE UISK 

OEVICES. IF yuu OU NOT HAVE ANY TU CONFIGURE, REPLY “WUONE’ TU THE 
FOLLOWING QUESTYUN, 

ROW MANY CeHTRIDGE MODULE DISKS OU YOU HAVE? 

2 


CARTRINGE MOLULE OISK NUMBER 1 
WHAT CHANNEL NUMMER WILL FRIS DEVICE BE ON? ‘ 
1500 


CARTRIDGE MODULE DISA NUMBER é 
WHAT CHANNEL NUMBER WILL THIS DEVICE BE UN? 
1580 


WE aRe NUw RESOY FU CONFIGURE aL sTURAGE MODULE 

DEVICES. IF YOUU VU NUT WAVE ONY TU CUNFEGUREs REPLY "NUNES TU THe 
FOLLOWING WUESTIUN, 
HOW Many STURAGE MODULES vU YOU Have? 


é 

STORAGE MODULE NUMBER 4 
WHAT CrAtheL NUMGEN WILL THIS DEViCe BE UN? 
1860 


STORAGE MUOULE NUMBER 2 ‘ , 
WHAT CHANNEL NUMGER WILL THES DEVICE we ON? 
1880 


WE ARE NUW READY TO ClNFIGURE CanG NEADER Devites, IF Yuu 

DO NOT HAVE ANY TU CUNFIGUWE, REPLY TIHUNE’ TU Tre PULLUWING WUESTLUN, 
HOW MANY CANDO REAVEKS OU YUU HAVE? 

2 


CARD READER RUMBER 1 : 
WHAT CRANNEL NUMMEN WILL THIS DEVICE BE UN? 
2200 


CARO READER NUMBER 2 

WHAT CHANNEL NUMPER wWILG THIS OEVICE BE UN? “ 
ves 

INVALID CHANNEL NUMBER? MUST BE CAACTLY @ CreakaCTEHS LUN $ 
WHAT CHANNEL NUMBER wILL THIS OEVICE Be UN? 

22890 


WE ARE NOw READY TU CUNFIGURE C&eD PUNCH &ND kKEADER/PUNCR GEVICEd. 
_ NOTE THAT THIS IS EITHER & CARD READER/PUNCH Ure & CARD PUNCH, 


Figure 4-] (CONt). using M4_SYSDEF 
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IF YOU PU NOT MSVE ONY TO CONFIGURE, REPLY ' 
“NUNE" TG THE FOLLUWING QUESTION, 

MOWw MANY CARD RESQER/PUWCHES UR PUNCHES DU YOU HAVE z 
NO 


WE ARE Niiw READY TO CUNFIGURE ALL PRINTER DEVICES. Ir YUU OU NUT 
HAVE ANY TO CUNFIGURE, REPLY 'NONGt TO HE FOLLUWING WUESTIUN, 
HOW MANY PRINTERS DU YUU HAVE? 

1 . 


PRINTER NUMBER 1 
WHAT CHANNEL NUMBER WILL THIS DEVICE Be UN? 
1780 


WE ARE NUW READY TU CUNFIGURE ALL S@TRACK MAGNETIC taPE CeVICES. 
IF YOU 00 NOT Have ANY TU CONFIGUNE, REPLY 'NUWEt Tu [ee PULLOWING 
QUESTION, 

HOw MANY GeTRACK MAGNETIC TAPE DEVICES vU YUU HAVE? 


é : 7 
MAGNETIC Ta?E DevVICE NUMBER t 
WHAT CHANNEL MUMGER wILL THIS OEVICE He UN? 
1790 
MAGNETIC TaPe HEVICE NuMBER 2 
WHAT CRANNEL NUMMER WILL THIS OFVICE RE ON? 
19900 


Loan 


IF YOU wISM YOU MAY UPTIMIZE ALL FUNCTIUNS FOR THe GWEaTest 
POSSIBLE SPrEN, SUT AT THE EXPENSE UF HAVING & LARGE KESITUENT SYSTEM, 
DO YOU wITSe TO HAVE ALL SYSTEM OVekKLAYS RESIDENT? ores UR NO) 
nQ 


BY MAKING PARTICULAR UPERATING SYSTEM [WPUT/UUTPUT UVERLATS PERMANENTLY 
RESTUENT YUU CAN UBTAIN UPTIMUM Sree [-+ SOME CATEGUMIES, 

OO YOU wiSm TO OPTIMIZE THE READ VesWRITING UF RELAtive FILES? 

aa teu WISH TU OPTEIMEZE THe READI VGswe [TING UF HANDUM FILES? 

on cyiu wiSe FO OPTIMIZE Tete REAOL VOsWRITING UF INDEXED FILES? 

no You 41S TO OPTEMTZE RELATIVE FILES wIThH VELETABLE MECURDS? 

Mager *#ISH TU GPTIMEZE FILE MANAGEMENT UPENSCLUSE FUNCTIUNS? 

on vou wISet Tu NPTIM(ZE Tee REAOTVG sar I ING UF TAPE FILES? 

03 You wliSe Tu UPFIMIZE ESCOTC Tart FUNCTIONS? 

¥ 


? 
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OO YOU WISm TO CREATE & BATCK MEMORY PUOL? 
Yes 

oe BIG & BATCH POUL? (NNNNN OR NUK WORDS) 
20 


ENTER TRE NUMBER (2 TO 99) OF SYSIEM OVERLAY AXEAS 
YOU DESIRE, 
6 


WOULD YOU LIke TU SEE THE GENERATED STATEMENTS? 
ves 


SPROQDUCED BY INTERACTIVE BUILD (VERSIUNM 2.0)+ UN 198UsU9/UeG 11485702,5 
SYS 4 eSCIP, 6,18, 486 6k 

DEVICE CON00,0,5.%°'0800', CONSULE,140,,'KSK? 
LOBU CIPSIM 

LOBU SIPSIM_SP 

LOBU ZxXPFR 

© *GEOS6/MOU 200 VERSION 2,14°,'TEST SETe Une? 
RLGCK 

vVOaM 

LOBU ZNVUAM 

COMM GF 

ATD S3¢kteoX*FOSO' eo RIS, TTY! 

DEVICE AIOON, S-i1.R °F DAG? 

STTY @Tb00 coRECONNECT YES 

ATG Gp$2@,k*FCOO a p SHE, SPAUy SF 
DEVICE 47001,8,12,k *FCOO! 

3TTY aTWO] eoRECUNNECT YES 

VIF SelieX* FROG’ s oe -CeGe INL SOG-,FU 
OEVICE VIFOU,S- LEX FF OQ 

DEVICE ROPOO,6,1ti ok *FFOG? 

VEEP FolecB* PERO yg coe Ft 

OEVTEE VIPGL,7,12-X°FF AG? , 
VIP Bell po X'FEUOt, 12 

DEVICE vIPO2.6-i1 6X rEDG?® 

H327O0 Golil,e X*hbAO*s -¥°FB*, eteEat 
DEVICE wS20009,41, °F 88G! 

MSS7O LOeLL,R*F BUG’ orp XIP7C*, x EB* 
DEVICE K$201-10-11 5X °F SOG! 

PVE Tlell oe X*F9OG', ok 

OEVICE PVEOO,11,11-.x8'F S00? 

PVE L12cT3 eX 'FS00' ce c2 

DEVICE PVEO1, 12,11, x'F 9008 

PVE £3,10-X'F9B0', pt 

OEVICE PVEGS,13,i0,x*F9QG! 

PVE 19610,-X°F940',s2 

DEVICE PVEOS,18,10,2'F9By! 

PVE £5010.%°F980'. 2 3 


Figure 4~1 (Cont). Using M4_SYSDEF 


OEVICE PVYEOG,15,10,x'F 980! 
STOLN 12,X%'Feadt 
$70 16,23.,¥74a04 


DEVICE 


STO00U,16,120X%'F 680! 


ROP TN3O0 


DEVICE 


STOGL-1o,teexX'Fesd? 


STO 17,29.,V780a 


DEVICE 


STO02,17,12,X'Foau' 


ROP TN300 


DEVICE 


STDOSs17-1eeX'h G80! 


POLIST 1 

S$TAPOL 23,24 
STOLN £3.%'F600' 
STO 18-23>,V7700 


DEVICE 


STO04,16,15-%'F S00! 


ROP TN1200 


QEVICE 


$7005,18,14,23'+600' 


STD 19,24,,V7700 


DEVICE 


ST000,19, 15ean'FG00' 


STO 20,25,,V7799 
DEVICE ST007,20,15.x'Fa00! 
RNP TN1200 


NEVICE 


- POLIST 


STAaPOL 


asc 2i. 


NEVICE 


S$TDO08,20,155xX*Fatt! 
1 

23,24,25 
10,xX'F000',»P 
BSCOO,21i,i0,x* Fuca! 


BSC 22,19,%'F080'. »S 


DEVICE 
DEVICE 
DEVICE 
DEVICE 
DEVICE 
DEVICE 


BSCOL,22,L0-xn*Foact 


CONO1, 23,19, X*O4AU', oe 78U1! 


OSKO0,24, Los xX' 9500" 
DSKV1,259,17,%'0580' 
OSK02,26.18-x' Lagnt 
OSKO3,27,19-x'1280! 


© DEVICE RCDOO,1.6ex%'1800* 


DEVICE 
OEVICE 
DEVICE 
DEVICE 
DEVICE 
OEVICE 
OEVICE 
DEVICE 
OEVICE 
DEVICE 
DEVICE 
DEVICE 
DEVICE 


FCU0U,28.6,-%'1490? 

REDO1,29,20,4'°1480' 
ROMO0, $0,21-%*1500! 
FEMO0, 34,2124 °15008 
ROMOL,32,22,%'1580° 
FEmMdL,33,22,x%°19808 
MSMO0,34,256%°13900' 
4$MO1,55,24,"'18580'° 
CORUO, 36,25-x%' 2200? 
CORO1,37,26,x%'228' 
LPT0U,38,27-4°1780' 
MT90U,39,28,x%'1700° 
M¥901,490,29,x%'°1900' 


MEMPCOL So-10000.P 
MEMPOOL Be +20960-P 
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MEMPOOL 
MEMPOOL 
MEMPOOL 
MEMPOOL 
MEMPOOL 
MEMPOOL 
MEMPGOL 
RESOL& 
RESOLA 
RESOLA 
RESOLA 
RESOLS4 
RESOLA 
RESOLA 
RESULA 
RESOLA 
RESOLSs 
RESOLA 
RESOLA 
RESOLA 
RESOLA 
RESOLA 
RESOLA 
RESOLA 
RESOLA 
RESOLA 
RESOLS 
RESOLA 
RESOLA 
RESOLA 


MAP >SID>CLM_ Map 


QUIT 


eAtipe, PCY 


ei. 0, ae 
0L1,a8 
oie, a8 
eL3,Aae 
7.4, 68 
eh S- as 
OYUPK1 
GYWREL 
ORD KY 
O¥ Rw) 
OZXINY 
O2xSUV 
UZXSUB 
OYDMRS 
C¥YuUMC 
oruePc 
OZCity 
UZCKEY 
OZCLNK 
OZCPSN 
oZc sue 
OZUCCH 
OZUSUG 
OYOmMT 
OZTUFL 
O<tETa 
OZTATE 
OVOMRe 
OYUPN 


BDO YOU waNTt 10 CREATE THE CLM OIRKECTIVE FILE NUN? 


YES 


WOULD YOU LIke TU USE & FILE NAME UTHER THAN CLM _USEX 


YES 


ENTER YOUR FILE NAME om 


EXAMPLE 


é 


CLM FILE Neve FS2 
*SYSSRM>UDD>SYS_AUMIN>SANGORNOMUK2, 1 DEXAMPLE Sh 
RESTART FILE NAME IS: 
“SYSSRM>UDU>SY9_AUMIN=SANBORNSMAN2, 1 >MaRST ft 


Figure 4-1 


e 
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. A 


FUR THES Pile? 


Example 2% 


To modify the CLM directive file created in Figure 4-1, the user 
invokes the M4_SYSDEF program in rebuild mode. specifying the name 
of the restart file on the command line. Figure 4-2 illustrates the 
rebuild mode dialog. 


MULSYSMEF MaWST,] | 

Yu WAVE EMTFPRED wa SYSNFR [4 THE READILY MONE, 
NY YOU #&&NT TO SFE THE EXISTING CLA STATEMENTS? 
YES 


ePPUPLCEN HY [TMTERACTIVE BUELD (CVERSTON 2,0)4 Om 1980709705 1427:45,3 
SYS 4eSCTPeee 14, Gu, F 

NEVICk CARO, Up Se, ROA ,CONSOLE, ties RSH? 
Lhe CTO SL 

LOPU STPST*, SP 

Leu 2keRS 

2 'BRUSestEON atu VFUS EO elt, PEPPERELL BA,! 
RLOCK 

¥ode 

Olt FR yi ade 

C ive & 

ATM FeI1,xc*eNHnt,, tlt, ' TTY? 

NEWICE afer, 3,11, %'F DAG ' 

STPY austere | ew ECCT TES 

STP a,1ep CEC GO',, tml, tei! 

DEVICE ATi 1,4,7 2,1 FEMA! 

STTY 6701 ewkC(INeCT YES 

VEEP Selle et PENNE, , Cee PIANO, FA 

NEVITr VIPFUO,S,t1, CFE Oe! 

NEVICe ROPOU, mL i, CER OOF 

VIP 7,1e2,n'FFHN',,,, Ff 

HEVTIAR vient, /,{a,x'FF ao! 

VIP A,ll,ex'FFUOt,, 128 

NEVICE Viele, aeJ1, eth Fant 

43270 Gell, Xt AGNI, , <'TA KIBET F 
YEVICE »4200,9,41,8 °F ean! 

HPT VUZ1TT,XIF AND, KEE pa tee! 
NEVIRE KPSPOT, EN, 1 t,x hawt 

BYE Fiplie¥*EVON',,} 

HEVICE PVEUO, LT, t1, 8 °F Andt 

PVE 12,11 pr RYAN, 2 

NEVICKR PVE NL, LA, ge xt F9nst 
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PVF 135,10,"°F9RO',,1 
NEVICE PVEN!2?,13,30,x'FSAO! 
PVE 14-10,x%°F9A0',.2 
NEVICE PVE03,14,tQ9,a'FOun? 
PVE 15¢10.x"'F980',,% 
VEVICE PVE08,15,10,xR°FORn0? 
STALN 12-x'FeaG! 

STP 16523, ¢V7HHe 

NEVICE STNNO, 161A, tI Feat! 
ROP TNSOO 

HEVICE STHOE, 16,29," ' Feat? 
STR 17,28,,v7aha 

DEVICE S$TOO2,17,1a,a'Faant 
ROP TH 406 

NEVICE §$TH63,17,19, x5 'Feant 
PQGILIST 1 

STAPNL 24,26 

Sinem t3ex*h aon! 

STN Ta,eser-v77AA 

NEVIAF STH4,148,13, x °F Ryo! ~~ 
QP Twi2Ad 

MNEVIFE STNWH, 1A, IS, RSE ROE 

ST. {9,e,,u? iin 

HEVICE STNHHL,19,7 Spat Fait 

STH 20.8255 6V7790 

NEVICE $7H07,20,15,K Faun? 

ROP TRLAAG 

NEVICE STOOH, AHL L3, x*F ROO? 

PIS i 

STAPOL 23,24225 

BSE 21-10-x Fut’, 

HEVICE K6SCHHL 21.10, k' Faget 

4S 22,3, ¥ SFHANT,L,S 

NEVICE SSCN1,24,10, nt Fatt 

WEVIER CMO Ate FI O4Aat a poe FRuy 

MEVILE N§KO9, 29,16, elses? 

NMEVIECE OSKO1L. 25,97, xf O5an? 

JEVICE OSKN8, 26, 1a, KT 204! 

NEVICE DSKOS,27,19,x'1Aaqn't 

® HEVICE LEpMo,t,6.%' band? ‘ 

DEVICE FEOND. 29,6, KT 1adG! —~ 
DEVICE REDV1 29, 200% ° 14850? 

MEVICE ROMOO. 39,.2et. £81589! 

NEVICE FOMOH’ 31-21 -k%'°1506° 

NEVICE REM01, $2,22,%°15a0° 

HEVICE FCmI1, $3,22,x°1590" 

MEVICE MSMN0, 30,985,451 850" ‘ 

NEVICE M§n01,35,2a,0' 4 aaf? 

HEVICE CHhrod, 36,°5,"4° 2200! 

MEVICE Cheo1.37?,26,%'aeaot 
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DEVICE LPTOC, $6,27,x%°3780' 
DEVICE MT900,39,28,x'1700' 
DEVICE MT901,80,29,x%'1900' 
MEMPOOL $2+10000,P 

MEMPOOL 8,+20480,? 

MEMPOGCL + 486,9,PCU 

MEMPOGL +i 0,A8 

MEMPOOL «Lt, Ad 

MEMPOOL »-L2,48 

MEMPOOL »-L3,48 

MEMPOOL «19, 48 

MEMPOOL »LS,Aa 

RESOLA OYuUPX 

RESOLA OYWRXt 

RESOLA OYROX! 

RESOLA OYRwxt 

RESOLA OZKENV 

RESOLA O2ZxSOV 

RESOLA OZxSyA 

RESOLA OYOMRS 

RESOLA OYOMCE 

RESOL& GYUPC 

RESOLA OZCINV 

RESOLA OZCKEY 

RESOLA OZCLNK 

RESOLA G7CPSN : * 
RESGLA OZCSUA ; é 
RESOL& O2ZICCA 

RESOLA OZUSUA 

RESOLA OQYOMT 

RESOLA OZTUTL 

RESQOLA OZTETA 

RESOLA OZTATE 

RESOL& OCYOMRe 

RESOLA OYOPN_ 

MAP >STO>CLM_MAP 

sult 


NO YOU wISH TO MOUTFY NEVICES NR SYSTEM PARAMETERS? 
RESPOND wITh “SY¥STEM*, "GCEVICES",. "VIEW", OR "OUNE", 
RESPONSE = 

NEVICES 


RESPOND WITH TWE CEVICE TYPE OR CLASS TraT yOU wISH TO MODIFY, 
"COMM", “CON®, “OSK"%, "RCO", "MSM", "CMO", "COR", 

"CRP, "LPT", *MTP*®, OR "DONE", 

RESPONSE = 

COMM 


00 YOU WISH 70 MOOTFY THE COMMUNICATIONS LEVELS A4NO THE NUMBER OF 
MLCP'S (COMM), THE VIP'S (VIP), THE MOST LINKS (#3270), THE 
PYES (PVE), TWE SYNCHRONOUS TERMINALS (STO), 


THE ASYNCHRONOUS TERMINALS (ATO). OR THE O8C'S (88C)? 
RESPONSE « 


COM 
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NOES THIS SYSTEM HAVE ANY COMMUNICATIONS TYPE DEVICES? 
locEos VIPS. TTYS, ETC. 
NO 


90 YOU WIS TO MOUTFY THE CUMMUNTCATIONS LEVELS 4NO THE NUMBER OF 
MLCPT'S (COMM), TRE VIP'S (VIP), THE HOST LINKS (H3270), TRE 

PVES (PVE), THE SYNCHRONOUS TERMENALS (STD), 

THE &SYNCHRONOUS FERMINALS (A876), OR THE BSC'S (BSC)? 

RESPONSE = 

NONE 


RESPOND wITm THE DEVICE TYPE OR CLASS THAT YOU wISk TO MODIFY, 
"COMM", "CNM*, "OSK*, FRED", "MSM", "CMO", *COR*, 

*CRP*, “LeT", "MTP*, UR "DONE". 

RESPONSE & 

HONE 


AO YOU wiSh TO MOOTFY DEVICES OR SYSTEM PARAMETERS? 
RESPOND WITH "SYSTEM", *HEVICES*, "VIEW", OR "DONE*, 
RESPONSE = 

SYSTEM 


nO YOU afS# TO MOUTFY THE PROMPT (PROMPT), MEMORY SIZE (MEMURY), THE 
NUMAFR OF INTERACTIVE USERS (USERS). TRE AUTOMATIC GENERATION GF 

SPO NAMES (SP0),THE AUTOMATIC CRANNEL ASSIGNMENT (CHANNEL), THE 
RECORG LOCKING FEATURE (RLOCK)+ THE SYSTEM OVERLAY AREAS (SOAT), THE 
RESINENT OVERLAYS (RESOLA)> TRE DISPLAY FORMATTING FEATURE (VOAM), 
THE COMMERCTAL OR SIP SEMULATORS (SIMUL), 

QR TRE SYSTEM ANDO TNSTALLATION IDENTIFICATION (IDENT)? 

RESPONSE = 

RESOLA 


Te YOU aISh YOu MAY OPTIMIZE ALi FUNCTIONS FOR THE GREATEST 

POSSTOLE SPEEDO, HuT AT THE EXPENSE OF HAVING & LARGE RESIDENT SYSTEM, 
90 YOU wiSe TO HévE abi SYSTEM OVERLAYS RESIOENT? (YES OR NO) 

Yes 


00 YOU wlSh TG MOUTFY THE PROVPT (PROMPT), MEMORY SIZE (MEMORY), THE 
NUM@ER OF INTEQ ACTIVE USERS (USERS), THE AliTOmMAaTIC GENERATION OF 

SPO NAMES (SPO), THE AUTOMATIC CHANNEL ASSIGNMENT (CHANNEL), THE 
RECORG LOCKING FEATURE (RLOEK)> Teé SYSTEM OVERLAY AREAS (SOAT), THE 
RESTOENT OVERL&YS Di TRE DISPLAY FORMATING FEATURE (VOaM), 
TRE COMMERETAL OR SIP STMiLaTORS (S)JMUL),. 

OR TRE SYSTEM ANO INSTALLATION IDENTIFICATION (IDENT)? 

RESPONSE s 

HONE 


50 YOU WESR TO 4GOTFY DEVICES OR SYSTEM PARAMETERS? 
RESPOND WITH "SYSTEM", "CEVICES". “VIEW", OR "DONE", 
RESPONSE = F 
NONE 

eane YOU LIKE TO SEE THE GENERATED STATEMENTS? vt 
YE 
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ePRONUCEND BY INTERACTIVE BEL RD (V¥eERSTON 2.4)6 ON 1980409705 14342 548,3 
SYS 4 +3CIPs6,tA,44,,E 

NEVICE €1100,0,524° 9400! ,CANKSOLE, 14656 'KSR® 
LOBU CIPSIM. 
LOBU S$TPSIM_SP 

LOB ZXPFR 

® 'GCOS6/MND 490 VERSION 2e1', PEPPERELL Ma,* 
RLOCK 

VnaM 

LOAU ZNVNAM 

NEVICE CANO1,23,15-x4°R480',,,,*7HuL! 
VEVICE O8K00,24, 16," 'u5G4! 

NEVICE O8403,29¢17-%'O5a05 

NEVICE NS$<h2,26,)8,%'1209° 

DEVICE OSKOS,27,19, K's 28" 

e PEVICE RCOOY,1,6,x' ann? 

NEVICE FCO00,28,5,x%'1400' 

NEVICE RCD01,29, 20,x* aan! 

NEVICE RCmN0, 30,21,%'1500!' 

NEVICE FCHOO, 31,71," °1569" 

NEVICE REMOL,32,22,x%'15a0' 

MEVICER FCMO1,33,22,"'15a0' 

MEVICE MSM90,34, 93, x57 AGN! 

NEVICE MS$401,35,24,%' {940° 

AEVICE CHRO0, 36,25, 58 AA0Nt 

NEVICE CORO1, 57,26, 22an? 

NEVICE LPTO0,3A8,27,K'17Aa0! 

DEVICE MT9N0,39,268,xn'1700' 

NEVICR MT901,49,29,x'°1990'8 

MEMPOOL S-e-19000,°P 

MEMPOOL 8.,20080,2 

MEMPOQOL »AB,e,PCl 

MEMPOOL +L, an 

MEMPOOL -LJ,Ao 

MEMPNQL »L2, a4 

MEMPONL -L3,45 

MEMPOOL -L4,86 

MEMPOOL -L5,498 

CLMIM RESOLA 

MaP >STO>CLM_ae 

AUIT 


HO YOu wANT TQ CAFATE THE CLY NIRECTIVE FILE NOW? 

Yes 

WOULMD YOU LIKE TN USE A FILE taAnF OTHER TH4ty CLM_USER FOR THIS FILE? 

YES 

ENTER YOUR FILE NAaMe oo 

EXaMPLFTA 

CLM FILE waw€ TS33 
“SYSSRMPUNNP>STS_ AN l NaS ahAenrynhr»exambt ER 

RESTaRT FILE wawk TS? . 
“SYSSRMPUONP>SVS_ANVI NSS AANA >OM, PMaNST .2 
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SECTION V 
BASIC CLM DIRECTIVES 


This section deseribes the CLM directives used to define the basic 
characteristics of the system. The CLM directives for the optional 
communications environment of the system are deseribed in Section 
VI. If you are a first-tine user, you should be thoroughly familtar 
with all the tonics discussed at the beginning of this section 
before you create your CLM directive file. 


Appropriately coded CLYU diractives (including those for 
communications, if aoplicable) must be placed in the CLM_USER file 
under directory SID on the bootstrap volume before a stage 2 or 
stage 3 system startup is performed, (The stages of system startup 
are described. (The stages of system startup are described in 
Section IIIf). 


Table 5—-I summarizes the basic CLM directives, which are described 
ln alphavetic order later in this section. Briefly, these CLM 
directives define the following aspects of the system: 


- Systen variables such as sower line frequency, scan cycle of 
real=tine clock, Selentific and/or Commercial Instruction 
Proces30r options, number Of system overlay areas, number of 
trap save areas, number of internedi3te request blocks, and 
zvoanded error message code option (SYS directive), 


« Character{stics and sizes of system nemory pool, online memory 
pools, and batch memory pool (if any) (WMEMPOOL directives). 


« Physteal and logical characteristics of MOC-connected 
sertopheral devices (DEVICE directives). 


- System overlays that are to be made sermanently resident 
CRESOLA directives). 


- .Berating system extensions that are to be made permanently 
resident (LDBU directives). 


» system ohysical attributes, system structures, device status, 
user~defined variables, and memory pool specifications (MAP 
lirective). 


» Single character expressions that may be used tn certain 
directives {nstead of constant values (VARIABLE directives). 


5201 


. Userewritten device drivers that are to be made permanently 
resident and characteristics of the devices driven by them 
(ORIVER directives). 


—_ 
Table 5-1. Summary of Basic CLM Directives 
CLMIN Causes subsequent CLM directives to be read from a 
different device/file. 
# (Comment) | Used ta include a comment in the file of CLM 
directives. 
DEVICE Identifies a peripheral device and its 
characteristics, beth ohysical and logical. 
DRIVER Identifies a user=ewritten device driver and one 
device driven by it. 
/ 
LO3U Identifies a bound unit (usually userewritten) that 
ig to be made permanently resident in the system area 
of memorye 
MAP Provides conficuration information that allows you to 
verify the success of certain aspects of the system 
building process. 
MEM? OOL Defines the system memory pool, the batch memory 
pool, or one or more online memory pools. 
QUIT Indicates the end of the input file of CLM 
directives. 
RESOLA Identifies one or more system overlays that are to be 
made permanently resident in the system area of 
memory. 
RLICK Defines a pool of structures te be used by data ~~ 
management when record locking is requested. 
SY5 Defines a number of system variables, 
VARTABLE Allows you to define variables for parameters in 


certain CLM directive statements. 
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RULES FOR ARRANGING CLM DIRECTIVES 


Only a few rules aoply to the order of basic directives tn the input 
file read by the Configuration Load Manager. These rules are listed 
below. (Rules governing the order of communications~related CLM 
directives are described near the beginning Of Section VI). 


i, Each cammunications (MDC=-connected) peripheral device in the 
system must be identified in a separate DEVICE directive. (As 
described in Section VI, communications devices must be 
tdentified in DEVICE directives only if they are to be 
accessible through the file system). 


2. [f the operator terminal is cannected to an MDC, the DEVICE 
directive for the operator terminal should be the first CLM 
directive. This arrangement allows the operator terminal to be 
available for possible error messages related to subsequent 
CLM directives. 


3. If your configuration requires more than the default number of 
trap save areas (7) and/or more than the default number of 
intermediate request blocks (20), a SYS directive with 
appropriate tsa and irb argument values should be placed as 
close as possible to the beginning of the file of CLM 
directives. The addtional trap save areas and/or intermediate 
request blocks are available as soon as the SYS directive ts 
read. 


4. If the CLMIN directive is used, {t must not precede the DEVICE 
directive that identifies the device implied by the pathname 
argument of the CLMIN directive. ~ 


5. If LDSU directives are used to identify both a SIP Simulator 
and a Commercial S{mulator, the simulator identified in the 
Tatter LDBU directive will be the first to process a trap to 
the trap vector shared by the two simulators. 


4. A variable must be defined by a VARIABLE directive in the CLM 
file before [t can be used in subsequent directives. 


7. QUIT must be the Last CLM directive in the tnput file. Any 
directives that follow QUIT wil not be processed. 


FORMAT OF CLM DIRECTIVES > 


A CLM directive consists of a string of up to 72 ASCII characters. 
The format of a CLM directive is shown below: 


mnemonic argument_il ,argument_2]{ ,argument_31]...f,argument_n} 


In the directive descriptions in this section and in Section VI, the 
following conventions apply: 
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!, The directive mnemonic is shown in uppercase. It must be 
specified exactly as shown. ' 


2. Exactly one space must separate the directive mnemonic from 
the first argument. 


3. In arguments, lowercase words and letters indicate values that 
must be specified by the user. ' 


4, arguments within square brackets {] are optional. 


5. Vertically stacked arguments within braces {(} represent 
options, one ef which must be chosen when the argument is 
used. 


4. Arguments ina directive are separated by commas. Embedded 
blanks are not allowed within arguments. Blanks are not 
allowey between arguments. 


7. A blank terminates the list of arguments in a directive. 
Anything following this blank is considered a comment. 


8. All arguments are positional, meaning that they must be 
specified in the order shown in the directive description. If 
a jiven argument is omitted and a following argument is used, 
the omitted argument must be signified by delimiting commas 
Ceege, DEVICE LPTO2,15,22, X7%13807,,,N). 


9. Trailing commas are not required after the last argument. 
10. Continuation lines are not allowed. 


Ji. Unless stated otherwise, unsigned positive integers less than 
or equal to 65,535 (10) (FFFF (16)) can be expressed in 
decimal or hexadecimal. 


If a value exceeds 65,535 (10), it must be expressed in 
double-word hexadecimal format (i.e., D¢hhhhnhhh’). 


A decimal integer consists of one or more decimal digits 
(@.g., 1234). 


A hexadecimal channel number consists of the constant "X"# 
followed by four hexadecimal digits expressed in the format: 
X70? (OeGey X“FFS8O%). 


12. If an ASCII character string begins with a decimal digit, the 
string must be enclosed within apostrophes (e.9., “%1A%). 


~ 13. The line length specified for a terminal or other input device. 
at system building time overrides the command processor line 
length of !27 characters. For example, at a terminal 
configured with a line length of 80 characters, you cannot 
enter a continuous command line longer than 80 characters 
unless you type an amoersant (&%) at the end of the line and 
then continue on one or more additional lines. You can alter 
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the terminal’s line Length by using the set terminal 
characteristics (STTY) command (described in the Commands 
manual) after system initialization or ey modifying the SiTIY 
directive tn your CLM file, 


14, For each noncommunications device configured, you have the 
option of specifying a channel number or allowing the system 
to dynamically assign or “float” channel assignments at 
startup time (1). To float a channel, you specify the channel 
number parameter {in the appropriate DEVICE or DRIVER directive 
with a single zero (0). The system then assigns appropriate 
devices to any available channels. Note that if you specify a 
zero channel and the system cannot locate an appropriate 
device for it, no error message is issued, 


M4_SYSDEF, the interactive CLM directive generation program, allows 
you to float channel numbers for all neoncommunications devices, if 
you so choose. See Section [V for details. 


Channel numbers are assigned according to the order in which DEVICE 
or DRIVER directives with zero (0) channels are specified in the CLM 
file. To prevent devices wlth zero channels from inadvertently 
preemoting devices whose channel numbers are explicitly speci fied, 
all devices of a given type with explicitly specified channel 


numbers should precede all devices of that type with zero channels 
in the CLM file. 


ror noncommunications devices, the first available device having the 
lowest bus address and the correct device identification is assigned 
to the first avatlable WOC-connected DEVICE or DRIVER directive 
encountered in the CLM file, and so on. 


If a system its configured {th devices containing zero channel 
numbers, you may determine all channel numbers assigned by the 
system after system initialization. The system operator can t¢sue 
the command STS ~ALL to list each device and its channel number 
assignment. 


Specifying a DEVICE KSR diractive with a zero channel number causes 
the system to search for the first available MDC-connected 
keyboard/tyoewriter terminal. If none ts available, the system will 
assign an MOC-connected CRT/kewboard terminal to the KSR driver. 
Note that the KSR driver is caoable of operating only in command 
mode and single character node.: 


Specifying a DEVICE CON directive with a zero channel number causes 
the system to search for the first available MDC-connected 
CRT/keyboard terminal. [f none {1s available, the system assigns an 
4DC-connected keyboard/typewriter terminal to the CON driver, but 
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By assigning floating channel numbers to devices in the CLM file, 
the system builder need not know the channel numbers at each 
Installation that will receive a cooy of the system software. 


only if the “terminal-type" parameter (the eighth parameter in the 
DEVICE directive) is specified as KSR or TTY. Note that the CON 
driver operates in field and command modes only, 


The system identifies the sresence of a device adapter and assumes 
that the corresponding channel numbers are valid and usable. In such 
a case, the system may associate an unusable channel with a physical 
device. If no device is avallable to satisfy the directive, the 
user is not informed. If 46 system included device adapters but not 
associated devices, then explicit channel numbers should be assigned 
to all devices within the device class. 


PRELIMINARY CONSIDERATIONS 


The following paragraphs describe: 


o How to incorporate overlays and user=written bound units into 
your configuration. 


e Memory allocation and usage. 

« Performance considerations. 

e How to identify your  xeripheral devices. 
o How to configure the Operator terminal. 
e Pile system pathnames in CLM directives. 


You should review each of tnrese topics before you create your CLM 
directive file. 


System Overlays ee ee, 


ANithin the system software, many system functions are implemented as 
overlays. Each system overlay runs in 4 5i2-word system overlay area 
in the system area of memory. By default, one S!2-word system 
overlay area is created. If you wish, you may use the olan argument 
of the SYS directive to create additional St2-word system overlay 
areas (up to maximum of 99) so that multiple system overlays can be 
comresident at any time. In this case, the system will not be 
forced to repeatedly change the contents of the single system 
Overlay area as various system overlay functions are required. 


In addition to, or instead of creating multiple system overlay 
areas, you may wish to make certain frequently used system overlays 
permanently resident in the system area of memory (increassing its 
size at the expense of memory available for user tasks): This can be 
done by Means of the RESOLA directive. Each RESOLA directive aliows 
specification of One or more system overlays, each of which is 
loaded for oermanent residancy during system startup. The names and 
aoproximate sizes of all system overlays are listed in Anpendix 8B. 
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System Extensions 


x 


A system extension is an optional, user-written or system=supplied 
hound unit (consisting of re~entrant code) that is identified in an 
LOB directive and loaded, for permanent residency in the system 
area Of memory, during system conntgurae en (1). Multiple system 
extensions can be used. 


System extensions are most efficient when they are more or less 
continuously used through symbolic references from multiple 
application task groups and this usage does not permit a possible 
delay in the initial loading of the extension. 


Systam extensions may be used to define system=wide global address 
symbols. These symbols must have been defined itn EDEF Linker 
directives as each extension bound unit was linked. Later, as the 
bound unit ts loaded during system configuration (by virtue of the 
LDBU directive), the system-wide global address symbols are added to 
the system symbol table, where they can be used (by the system 
loader) to resolve any unresolved references to them occurring in 


subsequently loaded bound units. 


Any dynamic requests for memory originating from a permanently 
resident system extension are fulfilled from the memory nool of the 
task group that its using the extension. 


Note that if system extension code fis not concurrently used by 
multiple applications, it can be individually linked into aoplicable 
user=#ritten bound units and not loaded for permanent residency at 
system startup. In this case, an JDBU directive {fs not used, and 
the extension will reside [n memory only as part of each 
user=written bound unit with which {it has been Iinked. Appropriate 
symbols in system extensions used tn this way can be identified tin 
XDEF Assembler control statements and thus resolved at link time. 


Memory Allocation and Usage 


System startup allows main memory to be divided into the following 
areas (as a maximum)? 


- System area : c 


« System memory pool 
- Online nemory pools 


~ Exclusive 
- Nonexc lusive 


« Batch memory pool 


(1) 


The SYS Linker directive must be used when the system extension is 
linked. 
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The system area contains resident system software, one or more 
system overlay areas (as specified by the Olan argument of the SYS 
directive), any permanently resident system extensions (as specified 
in LOSU directives), and any user-written device drivers (as 
specified in DRIVER directives). The system memory pool, online 
memory pools, and batch memory pool are described in separate 
MEMPOOL directives (the batch memory pool is optional). Each 
MEMPOOL directive establishes the type and size of one or more 
memory pools. In the case of online memory pools, the MEMPOLL 
directive also establishes (1) the 2<character identity of each 
memory pool defined therein and (2) whether, for each memory pool 
defined, additional memory can be obtained, as necessary, from the 
baten memory pool (if any). 


Roots of bound units linked as sharable are loaded into the system 
memory pool, whereas roots of bound units linked as non-sharable are 
loaded into an online memory pool or into the batch memory pool. 
Each task group is associated with one and only one memory pool, but 
more than one task group May be associated with the same memory 
pool. See the System Comcepts manual for a more detailed description 
of menory pools. 


ACCESS TO MEMORY POOLS 


Following a system startup, all nondisk devices and files are 
initially accessible to task groups in online memory pools and in 
the batch memory pool (if any). The MFA (modify file) command can be 
used ({n an Online memory pool task group) to make a nondisk device 
or file {naccessible to the batch memory pool. However, when a 
subsequent system startup [|s performed, all nondisk devices and 
files are once again accessible to task groups in online memory 
pools and in the batch memory pool (if any). 


FRAGMENTATION 


One memory-related phenomenon, “fragmentation,” warrants mention 
here. Fragmentation is the development, within a memory pool, of 
unusable “holes*® or “fragnents"® of memory. It usually results from 
the dynamic acquisition and release of memory within a pool by a 
number of concurrently active tasks. Since the system’s memory 
manager satisfies dynamic requests for memory within a pool on a 
first-come/ first-served basis in consecutive multiples of 32-word 
blocks, it is possible that the order of memory acquisition and 
release may create a situation wherein a request for memory cannot 
be satisfied even though sufficifent free nemory exists. 


This situation might occur, for example, when a task has 
successfully obtained four areas of memory within a peel and the 
pooli’s free memory is nearly exhausted. If the task released the 
second area (e.g., !28 words) and the fourth area (e.g., 96 words), 


5-08 


ad 


the task’s subsequent request for 192 words might be unsuccessful 
because that much consecutive memory is not available (even though 
at least 224 words — the amount released —=- is available in two 
nonconsecutive areas). 


Note that if tasks obtain and release memory On a 
last-ohta{ned/first-release basis, the potential for fragmentation 
is reduced, especially when only a few tasks share a particular 
memory poll. 


The potential for fragmentation increases with the number of tasks 
sharing a memory pool and with these tasks’s dynamic use of memory. 
In general, the sytem memory pool becomes fragmented before user 
memory pools do. Calculations for memory pool size later tn this 
section include a factor to allow for potential fragmentation. 


Performance Considerations 


« Systems can be configured on hardware having an MMU without 
utilizing the MMU. This is accomolished by use of CLM MEMPOOL 
directives. If no memory osools are protected or contained, and 
mo batch pool exists (or an existing batch pool ts specified as 
not contained), then the features of the MMU cannot be used, 


« In a given configuration, tf any single nonexclusive pool has 
protect and/or contain attributes, all nonexclusive pools have 
the same attributes. 


« WMU Tarush Overhead : 
“MMU inrush is defined as the load of MMU by firmware at context 
restore time. 


~ If pools other than the system pool are protected and/or if 
pools other than the batch pool are contained, there will be 
an MMU inrush each time any task except a system task is 
scheduled. On a system with an MMU, the inrush will take 19 
microseconds for SAr and 37 microseconds for LAF. 


~ If only the system pool is protected and/or only the batch 
pool is contained, there is no MMU inrush overhead. A single 
load of the MMU occurs during system initialization and the 
MMU contents are not changed unless the system is 
reconfigured. (The only exception is that the MMU contents 
are temporarily changed at batch rollout). 


- If the system Is configured without orotection or 
containment, there Ls no inrush overhead. 


- For configurations {n which MMU inrushes occur, a data 
structure of 32 words for SAF (464 words for LAF) is required 
for each protected or contained pool and for the set of 
nonprotected noncontained pools. 
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Identifying Peripheral Devices 
Each communications (MDC~connected) peripheral device in the system 


must be identified in a separate DEVICE directive. The device may be — 


designated as accessible through the file system or accessible only 
through physical input/output. (As described in Section VI, 
communications devices must be identified in DEVICE directives only 
if they are to be accessible through the file system). 


The DEVICE directive*’s arguments. specify the characteristics of the 
device: 


Unique device unit identifier 

Priority level number 

Channel number on Megabus 

Unique logical resource number 

Unique device name for file system references 
Maximum record size 

aJuffered/unbuffered input/output 
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Configuring the Operator Terminal 


' The following paragraphs describe characteristics of the. Operator 


terminal and the various configuration options available to you. 


OPERATOR TERMINAL CHARACTERISTICS 


The operator terminal is the single device designated as the control 
terminal for the system, It must be assigned to Irn 0 at system 
configuration time in order to be identified by the system, 


The operator terminal is the only terminal from which communication 
with the system task group SS is possible. Capabilities unique to 
the operator terminal include the creation of the batch task group, 
suspension and reactivation of batch and online task groups, 
peripheral device control, print/punch daemon startup, and the 
monitoring of system status. 


Normally, an operator terminal is configured during a stage 2 or 
stage 3 system startup. (An Operator terminal is always configured 


automatically in a stage |] system startup). The operator terminal 
may de a terminal connected to an MLCP/DLCP, 


CONFIGURATION OPTIONS 


As the system builder, you Save three options with respect to 
configuring the operator terminal t 
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. You can configure a terminal that will function as the operator 
terminal for the life of the system. 


- You ¢an configure a dual-purpose terminal that can funtion 
alternately as an operator terminal and as a non operator 
terminal. 


& 


« You can choose not to. configure an operator terminal. 


You Might choose the first option if you wish to always have one 
terminal reserved for the operator’s exclusive use. This terminal 
would always have the capability to perform those control and 
administrative functions unique to the operator. Note that the 
Operator terminal cannot support forms processing software. 


The second configuration option allows you to assign a dual function 
and identify to the operator terminal. You assign two unique names 
to the terminal: a “device name” that identifies the terminal when 
it {s functioning as a noOn-operator terminal, and an “operator 
terminal name® that identifies the terminal when it is functioning 
as an operator terminal. You might choose this configuration option 
if Operator functions will be infrequently performed and you wish to 
free the operator terminal for user applications (especially forms 
processing). The ability to perform forms processing will only be 
available to users when the terninal is functioning as a 
non-Operator terminal. 


Operating procedures for an operator’s console configured by one of 
the above methods are fully described in the Operator’s Guide. 


The third configuration, option does not permit commands and 
procedures unique to the operator terminal to be performed, You 
might choose this option if your system configuration will run under 
a dedicated aoplication. 


Configuring an Operator Terminal to Funetion for the Life of the 
system. 


A device configured to function as the Operator terminal for the 
life of the system will always allow users the capability to perform 
those control and administrative functions unique to the operator, 


If the permanently assigned operator terminal its connected to an 
MDC, the operator terminal must be tdentified by a DEVICE directive. 
This JEVICE directive should be first in the CLM directive file so 
that the operator terminal {3s available to receive any error message 
that relates to subsequent CLM directives. 


If tne permanently assigned operator terminal is connected to an 
MLCP/OLCP, both a DEVICE directive and an appropriate communication 
directive (e.g., ATD) are required. (A COW directive is also 
required). An MLOP/DLCP<connected operator terminal is activated 
only after system startup is complete. 


+ 


In either case, the logical resource number on the DEVICE directive 
must be explicitly specified as 0. Any appropriate level number and 
channel number may be specified. The record size argument should 
normally be set at 140 bytes (characters). Note that the specified 
record size affects only the file system’s use of the cperator 
terminalt regardless of the value of recordisize, the Operator 
Interface Manager always uses !40 characters as the maximum for its 
control of input and output operations to the operator terminal. The 
device name of the operator terminal may be any user-selected name 
(customarily, CONSOLE is used). 


Zxample | 
DEVICE CON00,0,8,X“0500% ,CONSOLE, !40,N.% 7200/2 


In this example, the Operator terminal is conencted to an MDC. The 
device unit name is CONOO. The logical resource number is 0 (a 
requirement for the operator terminal). The priority level is 8. The 
channel number is 0500. The device name is CONSOLE. The record size 

for file system access is 140 bytes. [1/0 to the device will be 
unbuffered. The terminal is a VIP7200. The default for visual 

display mode, ’T%, has heen accepted. ~~ 


Example 2% 


COMM 9 
DEVICE TIY00,0,11,X7Fr80% ,CONSOLE, 140 
TTY 0,11,X*FF807 


In tnis example, the oserator terminal is connected to an MLCP. The 
device unit name is TIY00. The logical resource number is 0 (a 
requirement for the operator terminal). The priority level ts il. 
The channel number is FF8O. The device name is CONSOLE. The record 
size for file system access is 140 bytes. In the COMM directive, 9 
is the priority level at which the MLCP will interrupt the central 
processor. In the TTY directive, default values have been accented 
for modem type and line speed. 


Configuring a Dual-Purpose Operator Terminal Uy 
You have the ootfion to donfigure a dual-purpose operator terminal. A 
dual-purpose terminal can function alternatively as an operator 
terninal and as a non-operator terminal. Only one device in your 
configuration may be configured in this manner. Users control in 

which capacity the terminal functions (as an operator terminal or 
non-opersatar terminal) by means of the OPER command described later 

in this section. 


If the device that will function alternatively as an operator 
terminal and a non-Operatos terminal is connected to an MDC, the 
device must be {dentified by a DEVICE directive with the first 
parameter as CONnn. This DEVICE directive should be the first in the 
file of CLM directives so that the terminal is available to receive 
any error message that relates to subsequent CLM directives. 
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For an MDC~connected device, the directive is of the form: 


DEVICE Ci0Nnn, Irn, level,X%channel’ ,device_name, record_size, 
N,terminal_type, {c} ,operator_terminal_name 
+ 


If the device ts connected to an MLCP/DLCP, both a DEVICE directive 
and an ATD directive are required. (A COMM directive ts also 
required). An MLCP/DLCP—cannected onerator/non=operator terminal is 
activated only after system startup is complete. [t is recommended 
that the terminal not be a dialed line. ; 

For an MLCP=cannected device, the ATD and DEVICE directives are of 
the form: m : 


DEVICE “ATDnn,irn,leveal,X’channel’ ,device_name,rec_size, 
N,.,o0erator_terminal_name 


ATO Irn, level, X’%channel’ ,modem,speed ,device_type,[del], 
(stop=-bitIl ,parity] 


In either case, the logical resource number (Irn) on the DEVICE 
directive must be explicitly specified and must be non-zero. The lrn 
you specify will be assigned to the device and the file having the 
name "device-name" (fifth sarameter). The system tmolicitly assigns 
lrn 0 to the file having the name “ooerator terminal_name"® (tenth 
oarameter). Lrn O may not be assigned to any other device. An 
approortate level number and channel number may be specified. The 
devica name (fifth parameter) you specify will be assigned to the 
terminal when it is functioning as a nonm-Operator terminal. An 
application task group’s standard I[/0 files (e.9., command-in, 
user-{n) will be assigned to the device name you specify.(1)} You 
nust specify that this device is unbuffered: the seventh parameter 
must se N. 


For an MO0C-connected terminal, the tenth parameter in the DEVICE 
directive designates this device as being able to function as both 
an operator terminal and a non-operator terminal. For an 
MLEP/DLCP=connected terminal, the tenth=<parameter, operator 
terminal.name, must be separated from the seventh parameter, N, by 
exactly 3 commas. The operator terminal name you specify will be 
assigned to users’ standard [/0 filles when the terminal is 
functioning as an Operator terminal. CONSOLE ts the curtomary 
designation.(2) 


C1) 


Only one aoplication task group can be assigned to the device name 
you specify. 


(2) 
Any number of application task grouns can be assigned to the 
operator terminal name you specify. 
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Example 18 
DEVICE CONO0,9,12,X71380% ,VIPOI,100,N,%7200% , ,CONSOLE 


In this example, the operator terminal {s connected to an MDC. The 
device unit name is CONOO. The logical resource number (lrn) ts 9. 
The exolicitly stated Irn value of 9 is assigned to the terminal 
when it functions as a non-Operator terminal. An Irn of 0 is 
implicitly assigned to the terminal when it functions as an operator 
terminal. The priority level is 12. The channel number is 1380. The 
name assigned to the terminal is VIPO!. The record size fer file 
system access is I00 bytes. The seventh parameter must be N, 
specifying that this device is unbuffered. The terminal tyoe for 
this device is 7200. The default for visual disnlay mode has been 
accepted. The name assigned to the terminal when it fs functioning 
as an operator terminal is CONSOLE. 


Example 23 


COMM 8B 
DEVICE .ATDO00,9,!15,X7Fr80% , VIPOO,80,N,.,CONSOLE 
ATID 9,15,X“FF80% ,0,9600., 7200 


In this example, the operator terminal is connected to an MLCP, 
The device unit name is ATDOO. The logical resource number is 
9. The explicitly stated lrn value of 9 is assigned to the 
terminal when it functions as a nOnoOperator terminal. An Irn of 
O is implicitly assigned to the terminal when it functions as 
an Operator terminal. The priority level is i5.° The channel 
number is FF80. In the COMM directive, 8 is the priority level 
at which the MLCP/DLCe will interrust the central processor. 


In the DEVICE directive, the name assigned to the device when 
it is functioning as a non~-operator terminal ts VIPOO. The 
record size for file system access is 890 bytes. The terminal 
must be designated as unbuffered (the seventh parameter must be 
N). The name assigned to the terminal when it is functioning as 
an operator terminal is CONSOLE. 


In the ATD directive, the modem type is 0 (direct connect). The 
line speed is 9500. Tne device type is 7200. Defaults have been 
taken for del, stop=bit, and parity. . 


At system startup, the terminal is running under the system 
task grous and functions as an Operator terminal. The initial 
switch from operator control to user control must be 
accomplished through an EC file you create. The location and 
purpose of this EC file should be communicated only to selected 
users. 


The EC file must contain the following commands: 


OPER -QFF |=-IM 
-~DEF 


SG jgroup_id user_id level user_in =<WD path -POQL pool Tid 
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The OPER -<OFF command transfers control of the terminal from 
Operator control to user control. The <IM control argument (the 
default) allows all messages processed by the Operator Interface 
Manajer (OIM) to be displayed while the terminal {is running under an 
application task group. 


The ~OEF control argument defers all OIM-processed messages until 
the terminal is returned to system task group control. However, 
messages sent to the terminal by two system routines, OPMSG and 
OPRSP, are never deferred. These messages aré displayed immediately 
to allow the operator or user to respond to volume tount reauests or 
“device not ready” messages. Messages sent to the terminal from 
other terminals using the “MSG command are also not deferred. I[f a 
user soecifies the -DEF argument and the QIM has deferred an outout 
Order, the OTM will issue 3a message at rejular intervals stating 
that outout is pending. 


The spaw group (SG) command initiates the aooropriate user grouo for 
the apolication. The spawn grouo command creates an application task 
group whose lead task must be the command processor. (The CG and EGR 
commands may be substitued for the SG command). the user=in file 
must be the same as the “device-name’ specified in the DEVICE 
directive when the terninal was configured. é 


{f a user wishes the terminal to function as an operator terminal, 
he aust execute the command OPER -ON. A message will appear at the 
terminal stating "OPERATOR HAS CONTROL*. [f at any time, a user 
wishes to return control of the terminal to his aoplication task 
group, he must type the command OPER -OFr. 


System Configured Aithout Operator Terminal 


A system cOnfigured without an operator terminal has the following 
characteritics: (1) 


- A S)PMSG (Operator information message) or SOPRSP (operator 
response nessage) macro call to the nonexistent operator 
terminal results itn a 0802 error return (invalid logical 
resource aumber) to the tssuing aooplication. 


« No operator terminal {Ls available to record system error 
messages, ready device nessages, and mount volume messages. As 
a result, error returns to the issuing aoplication occur 
immediately 


~ An inmout/output order to a device that is offline or not 
ready results {n a 0105 error return (device not ready) to 
the aoplication. 
(1) 
In a system configured with an operator terminal, these same 
charactertstics aoply within any task group that has used the 


SCMSUP (console message suppression) macro call ti temporarily 
suppress messages to the operator terminal. 
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=- A GET conmand or sGTrIL (get file) macro call to reserve 24 
volume that is not mounted results in a O20C error return 
{volume not found) to the aoplication. 


- A read or write hardware error results in a 0107 error return 
(hardware error) to the apolication. 


» No system=-supolied message can be issued to signal the 
termination of system startup. 


1 


File System Pathname in CLM Directives 


Whenever the format of a Configuration Load Manager (CLM) directive 
indicates that a file system pathname is to be suoplied as an 
argument, the pathname must be expressed in one of three forms? 


1. A full absolute pathname. 


This form of pathname is reauired to identify a file on a disk 
volume other than the system (bootstran) volume. 


A full abosulte pathname begins with a circumflex (*) and a 
disk volume root directory name (which is the same as the 
volume_id). Each successive element in the pathname is 
preceded by a greater=than sign (>) and is hierarchically 
subordinate to the preceding element. Every element in the 
pathname except the last is a directory name. The last 
(rightmost) element is a file name.(!} The last element is 
not followed by any symbol or punctuation. 


Examples: 
CLMIN “USRYOL>DIR_1] >FILE_A 


In this example, a full absolute oathname is used in a CLMIN 
directive. The pathname indicates a target file that exists 
on a disk volume other than the system (bootstrao) volume, 


2. An absolute oathname. 


This form of pathname is used to identify a file an the system 
(bootstrap) volume or a nondisk oeripheral device. 


An absolute pathname begins with a greater=than sign (>) and 

. the name of a directory or file that is jmmediately 
subordinate to the root directory of the system volume. The 
rest (if any) of the pathname is similar to the full absolute 
pathname Jescribed above. 


(}) 
In nroOn=-CLM environments, the last element in a pathname may be 


either a Jirectory name or a file name, as appropriate to the 
situation. 
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For a magnetic tape file, the absolute pathname must be 
tdevice_unit>volume_id>file_name. The value for device_unit must be 
specified in the related DEVICE directive. 


For other nondisk peripheral devices, the absolute pathname must be 
tdevice_name. The value for device_mame is as specified in the 
related DEVICE directive. (If device_name is not specified itn the 
DEVICE directive, the value of the devicalunit argument ts used for 
device_name, 


Examp Le 3 
DRIVER »DIR_Y>USRDRV - - 
In this examole, an absolute pathname ts used itn a DRIVER 
directive. This pathname itndicates a target file that exists 
on the system volume. DIR_LY is a directory immedtately 
subordinate to the root directory of the system volume. 


3. A Qelative pathname. 


Ouring execution of the Configuration Load Manager, this form 
of pathname is used to identify a file in this system task 
group’s working directory, in this case directory SID, which 
is immediately subordinate to the root directory of the system 
volume. ("*Relative*” means relative to the working directory of 
the task group). 


In this situation, the relative pathname is exoressed as a 
simple file name with no preceding or following symbols or 
ounctuation.(1) The named file must exist in directory SID on 
the system volume. 


Example? 


LDOBU RBRCIP 


In this examole, a relative pathname ts used in an LDBU 
directive. This pathname indicates a target file that exists 
immediately subordinate to directory SID on the system volume. 


In all types of pathnames, a directory name cannot exceed 12 
characters, a file name cannot exceed !2 characters, and the total 
pathname (facluding ~* and > characters) cannot exceed 57 characters. 
In a full abdsoluta pathname, the volume root directory cannot exceed 
six characters. The first character of each directory name and each 
file name must be alphabetic or a dollar sign ($). 


(1) =e 
Other forms Of the relative oathname extst, but their use with the 
Configuration Load Manager ts Jjiscouraged. 
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CLMIN 


CLMIN DIRECTIVE 


Directive Name: CLMIN 
A CLMIN (CLM input) directive causes the source of CLM directives to 
be changed from the current device/file to the one indicated by the 


pathname argument. All subsequent CLM directives are read from the 
indicated device/file (unless it too contains a CLMIN directive). 


Formats 


CLMIN pathname 


Argument Descriptions 
pathname 


Consists of an ASCII string that identifies the fille system oathname 
from which subsequent CLM directives will be read. 


Functional Descriptions 


In a file of CLM directives, a CLMIN directive cannot anpear ahead 
of the DEVICE directive that identifies the device implied by the 
pathname argument. 


When & CLMIN directive is read by the Configuration Load Manager, 
the iaput file {5s immediately transferred to the beginning of the 
device/file indicated by the pathname. Subsequent CLM directives are 
read from the indicated device/file. 


If a disk or magnetic tape volume is indicated by pathname, that 
volume must be mounted before system startup begins. 


Example 18s 

CLMIN “ABCDVOL>BETA 
In this example, subsequent CLM directives will be read from a file 
named BETA! on disk volume ABCVOL. An absolute disk pathname ts 


used. Volume ABCVOL must be mounted On a disk device whose DEVICE 
directive has already been read by the Configuration Load Manager. 
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Example 28 
CLMIN !ICDROO 


In this example, subsequent CLM directives will be read from card 
reader whose device_unit name fs CDROO. (Assume that the DEVICE 
directive for CDROO did not include a device_name argument’ tn this 
case, the device_unit argument value is used for file system 
references to the device). The DEVICE directive for CDROO must 
already have been read by the Configuration Load Manager. 
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NINTS 


COMMENT 


COMMENT DIRECTIVE 


Directive Namet * (asterisk) 

Tne COMMENT directive is used to include s camment in the file of 
CLM directives. 

Formats 


* Comment text 


Functional Description: 

When an * (asterisk) is the first character of an entry in the file 

Of CLM directives, the remainder of the entry is treated as a os 
comment and is not processad by the Configuration Load Manager. 


Comments can also be inciud3d on other CLM directives if they follow 
a blank after the last argument of the directive. 
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DEVICE 


DEVICE DIRECTIVE 


Directive Name: DEVICE 


A DEVICE directive is required for each MDC-connected peripheral 
device in the system. You may allow the system to dynamically 
assign channel numbers to appropriate devices on the bus. You must 
include a special format of the DEVICE directive in your CLM file if 
your installation will use a dual-purpose Operator terminal. Refer 
to "Configuring a Dual-Purpose (Operator Terminal” earlfer tn this 
section. 


Formats 
DEVICE device_unit,Irn, level ,X“channel’ ,{device_name], 
B 


Crecord_size),( (Ns J,(€’terminal-type? )( ,C/T] 


Argument Description: 
device_unit 


A string of five ASCII! characters. Thts first three characters 
identify the type of devicet the last two characters (alphanumeric) 
must be unique within the device type so as to identify one speci fic 
device of that type. Table 5=2 indicates the permissible values of 
device.unit, the device type indicated by each value, amd the 
default physical record size (in bytes) for each device type. 


Except where indicated, the default record size can be overridden by 
usa of an explicit record isize argument in the DEVICE directive. 


In the case of KSRnn, the device_unit argument also establishes the 
following characteristics for the terminal: 


Trailing carriage return ootion specified. 
Trailing line feed option specified. 
Leading control byte rxotion specified. 
Scho mode option speci fied. 


* ¢ @¢ # 


If you wish to change any of these characteristics of the terminal, 
you can do so by means of an .STTY (set terminal characteristics) 
command, a SSTTY macro call, or a STTY directive. 


DEVICE 


Device_Unit 
Value 


KSRan/CON AN 
L? Tan 
SPTna 
CDRAn 
CRPANn 
OSKnan 
RCDan 
FCD nov 
MSMina 
RCMnn 


FCMan 
MT7nn 
MT9nn 


Device Type Indicated 


r= 


* Terminal (49C=-connected) 


Line Printer 

Serial Printer 

Card Reader 

Card Reader/Punch 

Diskette 

Removable Cartridge Disk 
Fixed Cartridge Disk 

Mass Storage Unit 
Removable Cartridge Module 
Disk 

Fixed Cartridge Module Disk 
Magnetic Tase (7~track) 
Magnetic Tape (9=track) 


Taple 5-2. Unit Values and Default Record for Various Device (4) 


Default Physical 


Record Size in 


Bytes 


(Decimal) 


KSR=73 CON=80 


7 


256 (b) 
256(b) 


256(b) 
256(b) 
O(c) 
O(c) 


The KSR device_unit value ts included for comoatibility with 
previous releases. The CON device_unit value should be used when 
creating a new CLM directive file. The CON device_unit value must 
be used if the user intends to perform forms processing from an 


MDC-connected VIP 7200 or VIP 7205 terminal. 


Using 


the KSR 


device.unit value and the CON device_unit value will cause two 
different device handlers to be loaded. 


6 


The default record size for this device cannot be altered by means 
of the record_size argument of the DEVICE directive. 


¢c 


It is not necessary to issue a GET command or a SGTFIL (get file) 
macro call to establish the logical record size (and block size), 
The record size cannot be altered by the record size argument of 
the DEVICE directive. 


q 


Communications devices are deseribed in Section VI. 


irn 


Specifies the logical resource number by which the device ts 
requested. The value for Irn is a decimal integer from 3 through 


252. (lrn GO is used for the Operator terminal. 


bootstrap device. Irn 2 is reserved for system se). 
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Irn ! 


is used for the 


level 


Specifies the priority level used by the device driver for this 
device.’ The value for level is a decimal integer from 7 through 59. 
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X’channel? 


Specifies the 4-digit hexadecimal channel number of the device. (The 
leftmost 10 bits specify the channel number's the righmost stx bits 
must be zero). x 


If you specify the channel number by a single zero (0), the system 
will automatically assign this device to an aopropriate channel. 


If a DEVICE directive for a disk device contains an Irn of ! and a 
channel number of zero, the bootstrap device channel number replaces 
the channel number of zero, 


(device name} 


For 3isk and magnetic tape devices, the device_name argument must be ~~ 
omitted or specified as * (asterisk) because the device {dentity is 
established by the value of the device_unit argument. (The 
significance of using the asterisk {s described below). 


For devices other than dis« or magnetic tape, device_name can be one 
of the following: 


l. A string of up to 12 ASCII characters that establish a unique 
name by which the device ts referred to witnin the file 
system. The first character of the string must be alphabetic. 


2. Omitted, in which case the value of the device_unit argument 
ts used for file system references to the device. 


3. An * (asterisk), which {indicates a “nrivate” device to be 
accessible only through physical input/output. 
( recordisize) 
The length, in bytes, of ome physical record, [f recordistze {5s not 
specified, the default record size is as established by the 


device_unit argument. (The default record size for disk devices ani 
magnetic tapes cannot be modified by the record size argument). 


This argument is meaningful only for devices other than disk and 
magnetic tape. 
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For normally unbuffered devices (viz., CDR, CRP), B indicates that 
input/output to the device is to be buffered. 


For normally buffered devices (viz., CON, KSR, LPT, SPT), N 
indicates that input/output to the device is to be unbuffered. 


Input/output to a buffered device may be either asynchronous or 
synchronous: tabulation characters are exoanded into space 
characters. Input/output to an unbuffered device is always 
synchronoust tabulation characters are not expanded. 


NOTE: All arguments of a DEVICE directive must be unique (1.e., not 
duplicated on another DEVICE directive) with these exceptions: 
(1) the B/N argument need not be unique, (2) for pairs of 
removable/fixed cartridge disks, the same level number and 
channel number must be specified for both olatters (3) 
multiple communications devices may be configured on the same 
level and (4) multiple (polled) VIPs may be configured on the 
same channel. 


{*terminal_type?’) 7 


Applies only if the device_unit value is CON. Snecifies the physical 
terminal type. Possible values are described below: 


Value Physical Device Type 


27200 = VIP_- 7205 (DKU9103) 
VIP 7205 (DKu9102) 


The value 7200 must be used if MDC-connected 
VIP 7200 terminals are to be used for forms 

precessing using the Display Formatting and 

Control Facility. 


“PRU PRUIOOI/PRU | O03/P RU 1 005/TWU 1001 /TAU1OO3/THUI005 
“072007 VIP 7207 


*“KSR4 The vaiue KSR is used if the physical terminal 
type is to be supsorted in teleprinter mode. 


(C/T) 


Applies only if the device_unit value is CON. Specifies the visual 
display mode for the device. The value C indicates CRT mode. The 
value T indicates teleprinter mode. If C is specified, typed input 
will aopear without edit control characters (as it appears in the 
memory buffer). If T is specified, typed input will appear as it was 
keyed-in. The default value is T. 
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Functional Descriptions 


Each peripheral device in tne system must be f[dentifited in a 
separate DEVICE directive. The devicelunit argument (e.9., DSKO!) 
identifies both the type of device (DSK) and one specific device 
(Ol) of the tndicated type. The Irn, level, and channel number of 
each device must be unique (except in the case of a pair of 
removable/fixed cartridge disks, in which case the level and channel 
for both platters must be the same). 


The first DEVICE directive for each device type causes the 
appropriate device driver toa be loaded as part of the system. Each 
device driver is re-entrant, so that only One copy of each required 
Griver ts loaded to service all devices of the same type. 


A DEVICE directive for the bootstrap device its optional. If none is 
specified, the bootstrap device is assigned oriority level 4 (the 
default). {ff you wish to override the default priority level, you 
should specify a DEVICE diractive that indicates the anoropriate 
device_unit, logical resource number 1, desired orfority level, and 
a channel number of zero (e.9., DEVICE DSKOO,!],level,x70"). If the 
channel number {is not zero, the following message is issued: 1345 
CMD (DEVICE) SPECIFIES DUPLICATE DEVICE TYPE/UNIT. 


Example 1? 
DEVICE LPTO1,12,20,X% 1380" 
In this examale, the Line printer whose unit number 
ts O! its assigned logtcal resource number I2 and 
priority level 20. This device {s cannected to 
channel 1380. The following characteristics are 
established by default: 


- The device_name used within the file system will be the same as 
the device_unit (i.e., LPTOI). 


- The record size will be 137 bytes. 
Example 28 


DEVICE RCDOI,9,10,X%1400" : 
DEVICE FCDO1,6,10,X714007 es 


This examole illustrates DEVICE directives for a pair of 
removabdle/fixed cartridge disks. The logical resource number for 
gach slatter must be unique. The level and channel number for both 
platters must be the same. 
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DRIVER DIRECTIVE 


Directive Name: DRIVER 
The DRIVER directive ts used to identify a user=-written device 
driver and one device driven by the driver. 
Format: 
ORIVER pathname,lrn, level ,X’%channel’(,X’stack_size! 
RCTUsize? i ,X* "hhh? } 
Argument Descriptions 
pathname 


An ASCII string that tdentifies the file system pathname of the 
device driver bound unit. 


irn 


Specifies the logical resource number used to identify a device 
driven by this driver. The value for Irn is a decimal integer from 3 
through 252. 


level 


Specifies the oriority level used by the device driver. The value 
for level is a decimal integer from 7 through 59. 


X*%channel? 


Specifies the 4=—digit hexadecimal channel number of 4 device driven 
by this driver. (The leftmost i0 bits specify the channel number? 
the rightmost six bits must be zero). You have the option to allow 
the system to assign a channel number for this device by specifying 
@ single zero for this argument. If you choose this option, you nust 
also specify the X“hhhh’ argument described below. 


€ X% stack size i&CT_size) 
Specifies the sizes in words of (1!) the stack required by this 
driver and (2) the resource control table (RCT) used for a device 


driven by this driver. The sizes are specified by a four digit 
hexadecimal numbert the leftmost two digits specify the stack size; 
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the righmost two digits specify the RCT size. if the stack size 
and/or the RCT size exceed 255 words (decimal) you may use the 
double word hexadecimal format, D’hnhhhhhhh’, where the first four 
hexadecimal digits represent the stack size and the second four 
hexadecimal digits reoresent the RCT size. [f the driver {is to use 
the system routine ZIOSUB, the stack size must be at least 22 words 
for a SAP configuration and 40 words for a LAF configuration. The 
minimum size for the RCT is 3 words. If a smaller value {is entered, 
the system reolaces it with 3. The default values are 8 words for 
stack size and 16 words for RCT size. You must take the default 
values for both sizes or specify Both. You cannot specify one and 
take the default for the otnrer. 


( X7nhhh? ) 


Specifies a four-digit hexadecimal number corresoonding to the 
internal hardware id of the device being driven by this driver. 


Functional Description: 


The DRIVER directive causes the user-written device driver 
identified by the pathname argument to be loadei {nto the system 
area of memory. (Because this driver is loaded into the system area 
Of memory, the SYS Linker directive nust have been specified when 
this bound unit was linked). The user=-written device driver becomes 
a permanently resident part of the system software. (If the driver 
{ncludes inittalization routines to be executed when the driver ts 
loadad, these routines also remain permanently resident). 


The ORIVER directive causes creation of a resource control table 
(RCT) of the indicated size. [t also causes creation of a task 
control block (TCB) with a dedicated priority level. Atditional data 
structure initialization is achieved as described below, 


The data structures allocated for use by this device driver are 
sufficient only for physical input/output onerations. The RCT will 
be used by the driver to interface with the tndicated device. 
Input/output from a program can be {nitlated by a sROI0 (request 
input/output) macro call that identifies an anoropriate input/output 
request block (IORB). (The format of the [ORB is deseribed in the 


System Service Macro Calls manual). 


Each userm-written device driver runs at a dedicated (unique) 
priority level. [If a glven device driver (single task) drives 
multiple devices on different channels, one DRIVER directive is 
required for each device. Gach DRIVER directive must specify a 
unique Irn and channel number, and a common ortority level and 
gatnhname (see the examole). In this case a separate RCT and stack 
are created for each device but a conmon TCB is used. Multiole 
devicas of the same type, each with its own work area, are thus 
driven at a common priority level by a common task. (If a given 
device driver drives multizle taks, the pathname arguments in each 
DEVICE directive must be identical, but each task must have a unique 
oriority level). 
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The initialization of date structures caused by the DRIVER directive 
is summarized below, 


« An RCT of the indicated size is created. beaataceis below the 
RCT, space for a pointar to the TCB is provideds one word for a 
SAF system, two words for a LAF system. 


« The RCT is immediately preceded by a TCB pointer which is tn 
turn immediately preceded by the stack. 


« The pointer at the appropriate Irn offset in the logical 
resource table (LRT) is set to point to the channel/ilevel word 
(the first word) of the RCT. 


« The TCB pointer immediately below the RCT is set to point to 
the TCB. 


« The channel and level values of the ORIVER directive are 
entered into the channel/level word of the RCT. 


« The RCT is marked as having no volume descriptor block (private 
volume). Thus the device is accessible only through physical 
input/output (normally, the SRQI0O macro call) and not through 
the file system. 


« The TCB is marked as having a dedicated priority level. (The 
* JCB is also set to point to the entry point of the device 
driver). 


« The remaining area of the RCT is set to zero. The driver must 
inittialize the RCT as required. 


Examples 


DRIVER OIRECTORY 1 >OWN DRIVER, 12,9 ,X703007 
DRIVER DIRECTORY_! >OWN_DRI VER, 13,9 ,X70380/ 


In this example, 4 user-written device driver whose file name in 
OWNUDRIVER is identified. {t will be used to drive two devices under 
&@ single task... The level and pathname arguments of the two DRIVER 
directives are the samet the logical resource numbers and channel 
numbers for the devices are unique. The RCT for each device will be 
16 words. The size of the stack required by this driver is 8 words. 
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LDBU DIRECTIVE 


Directive Namet LDBU 


The LDSU directive causes the tndicated S5ound unit to be added to 
the end of the bound unit load list. The bound untt“s root ts loaded 
into the system area of memory after aii CLM directives nave been 
read. (Since the root of the bound unit will be loaded into the 
systen area of memory, the SYS Linker directive must have been 
specified when this bound unit was linked). Once loaded, the root of 
the indicated bound unit is permanentely resident in the system. 


If you wish to incorporate an optional system capability into your 
configuration, such as error logging or defective memory trap 
handling, you might be required to load one Or more hound untts 
using LDBU directives. Refer to Sections VII and VIII for 
descriptions of the hound units associated with optional system 
capabilities. 


rormat: 


LDBU pathname 


Argument Descriptions 


pathname 


An ASCII string that identiftes the file system pathname of the 
bound unit. 


Functional Ieseription: 


Applicationespecific code (usually in the form of subroutines shared 
amon3 multisle task groups) that is referred to symbolically during 
application executton can Se permanentely brought into memory at 
system startup by LDBU directives. The pathname tn each LOBU 
directive ts added to a bound untt load List. 


Tne order of LOBU directives governs the order in which pathnames 
are added to the list. If two LDBU directives specify the same 
pathname, the second one is ignored. 


After the QUIT directive (the last CLM directive) is read by the 
Confizuration Load Manager, the roots of the bound units {tdentifted 
by LOBU directives are permanently loaded into the system area of 
nemory. The symbol table for each such bound unit is added to the 
system’s resident symfol table List. Once a hound unit has been 
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loaded, any symbol defined therein by an EDEF Linker directive 
serves to resolve an unresolved reference to that same symbo! in a 

subsequently loaded bound unit. Otherwise, if a bound unit contains 

ap oreeer reference to a symbol, loading stops with an error 
alt. 


Examples: 
LOBU “ABCVOL>ALPHAI 


In this example, a bound unit named ALPHAI, which is a file 
immediately subordinate to the root directory of a volume named 
ABCVUOL, will be added to the bound unit load list. 


A bound unit loaded by means of the LDBU directive may contain an 
initialization subroutine table (IST). The IST defines one or more 
subroutines of the bound unlt that are to be executed once only, 
immmediately after the root ts loaded. If a bound unit contains 
initLalization subroutines, the Linker directive IST must he 
specified when the bound unit is linked. The label in the IST 
section is the argument to be entered in the IST directive. 


The format of an IST section is given below: 
label pc! 
RESV SAF,O Re U 


oc <sub! parameters to subroutine sub! (may 
be any sixteen bit value) 


DC : <sub2 parameters to subroutine sub2 (may 
be any sixteen bit value) 


(Ct) 
If the entry is 0, all memory used by the initialization 
subroutines is returned to the system after the subroutines have 
been executed (provided the subroutines have not caused the system 
tO create data structures on thefr behalf). To retain a subroutine 
in memory, specify n, where n is the number of words to be 
retained. In this case, take care not to extend the memory 
requirement beyond that allocated to the bound unit’s root when it 
was loaded. 
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DC <subn oarameters to subroutine subn (may 
De fe be any sixteen bit value) 
Dc ¢) 


RESV SAF,0 End of table sentinel 


sull @eoeveeoee 


@eeeocce se 


sul2 *eeecece 


eeaeeceaeesoae 


@eeoetceene ee 


subn @naeoese cee 
@eeeeaeoaes 


eens eae? 


Upon entrance to a subroutine, register 85 contains the return 
address. Before exit from the subroutine, register RI must contain 
the status. <A value of zero indicates correct execution. A nonzero 
value is the error code for this subroutine. [f the status is 
nonzero, the fallowitng message {s written to the error-out file, 
and a halt occurs. Execution of CLM cannot continue. 


1348 INITIALIZATION SUBROUTINE ERROR 


(error code returned to register RI) 
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MAP DIRECTIVE 


Directive Names “AP 


The MAP directive provides configuration information that enables 
you to verify the success of certain aspects of the system building 
process. The information presented by this directive includes the 
systen physical attributes, system structures, device status, 
user-defined varfables, and metiory onol specifications: This 
information can be used to ease the debugging of system extensions 
and userewritten device handlers. In addition, information (such as 
system symbols) is presented that would otherwise be unavailable, 


Format? 


MAP (path) [(.map_form,] (,map_form2]... ae, 


Argument Descriptions 
path 


Pathname of the file to which the mao lising is to be written. The 
pathname cannot be that of a communications device. The pathname 
must be able to be verified when the CLM reads tne MAP directive. 


If the pathname refers to a device file (e.g., !LPTOO), that device 
must nave been configured when the MAP directive is read. 


If the pathname refers to a disk file, the indicated volume nust be 
nounted on the drive of a device that is already configured and 
recognized by the file system when the directive is read. If the 

pathname refers to a disk file that does not exist, the file will be 
created (as long as the directory structure identifiled in the 

pathname already exists). If the file already exists, it must he a ee, 
variable sequential file. In this case, it will be opened in "renew" 
mode « 


The default map path value is >SID>CLM_MAP. 
(mao_form, ]...{map_formn] 
Any conbination of the map format arguments described below can be 
antered in any order. If none of these arguments is specified, the 
entire system map is written to the map file. The complete mas 
presents the following Information (in the order shewn)?t 

« System physical attributes 


« System structures 
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« User-written device driver attributes 


dvW 


- Device status for devices accessed by the file system 
. User-defined vartables . 
« Memory pool attributes 

- System extensions 


- User=selected permanently resident system overlays and system 
overlays made resident to serve as device drivers 


« system symbol table 
~BRIcr 
“BF 
Requests display of only the ohysical attributes, system structures, 


user-written driver attributes, and user~selected permanently 
resident overlays. 


~NDEV 
“ND 


“omits from the map the data pertaining to device status (devices 
accessed through the file system). 


~NVAR 

=“NV 

Qnits from the map the data pertai{ning to user-defined variables. 
“NP OOL 

-NP 

Qmits from the map the data pertaining to memory osools. 

~NRES 

-NR 

Qmits from the map the data pertaining to user-selected permanently 


resident system overlays and system overlays made resident to serve 
as device drivers. 


Ba | 
=NS 
Qmits from the map the data pertaining to the system symbol table. 
example | 
MAP -NS 


The system symbol table data is omitted from the map. The map ts 
written to the map file whose sathname is >SID>CLM_MAP. 
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f° «=C«Example 2:3 
= MAP !CONSOLE 


The entire map is produced and written to the console. The console 
output in this example is as follows: 
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CLM MAP 


» 


PHYSICAL ATTRIBUTES? 


GCUS6 MUDSO0—9L 2. beO5S/2H/ 1450 

SUP PRESENT 

Ni) CEP PRESENT / : “ 
MM PRESENT 

HIGH PHYSICAL MEMURY ADDRESS: 3FFFF - 
HIGH VIRTUAL MEMORY ADDRESS!  G6&DFF : 

TIME BETWEEN REALTIME CLOCK INTERRUPTS: 32 

OPERATOR CONSULE CUNF IGURED 

ERROR MESSAGE LIBRARY IN USE 


SYSTEM STRUCTURES: (MECIMAL NUMEKIC VALUES) 


as IRHS, 56 SAS, 10 SYSTEM (IVERLAY ANE AS, 
] RECURD LICKS CUNF IGURED 


USER-WRITTEN DRIVERSS 


Z111a88 HE LOUCATIIINe 5501 tnOdzs 5SHHO ENTRY ANORESSS S9DA 
LRNS2O0 LEVELZ2t CHANNEL =F E00 Ch AS ShHe HKCT af SD0tO 
STACK ALLUCATIUN SULA Tu SdEA 


210468 RELUCATIUNS SFAO ENDZ b6lf ENTRY ADDRESSs 46379 
LANSZ2Zt LEVEL E22 CHANNEL SCOO00 TCH AT 6655 RCT AT O70C 
STACK ALLUCATIUN 6689 Ti 6709 


Z11GaS HELIICAT LIONS Sad ENOt 641F ENTRY ADDRESSs 6479 
LRNB22 LEVELS22 CHANNEL 24000 (Ch AT 6655 RCE AT O@91€ 
STACK @LLUCAIION 6908 TO 6919 
DEVICE STATUSS (DEVICES VISIHLE Th FILE SYSTEM) 


SYMPI) CHANNEL NEVICE VOLUMF USAGE AVAILAALELSEC TORS VULUME MEMBER 
NAME TYPE 10 PHYSICAL LUGICAL SET NAME NUMBER 


RCDOG =. 1.400 2352 “CHECKL 54 0 0 
MSMO} = - 1.800 2301 * D) 
RCDO1 «1480 2332 8 D 
NSKOO 0400 2010 “VLhe26 1 502 S02 
NSkOl 0480 2010 “CLM 0 194 1S4 
osko2 1200 2010 * p 
OSKO3 1280 20190 “RET § 1982 1952 
CUNSULE 500 20ta* 2 
coRoO =: 11300 2008 * v 
LPTOO §=—.- 1380 2002 * ‘ 
USER*OEFINED CLM VARIABLES: 
azs # > 50 C z $00 D = 5000 & = $0000 
F = $555 J 2 FREPFFFE «© 32 FEFEFREFCE (8 = 0 P # 12C 
a20 Woes FFFFFCCR Z = FFRFEDSO 


MEMORY PUULS: 


$3 STAR1=9980 END=1 9EFF SIZEz 7580 VIRTUAL HIASS O 


dvW 


MAP. 


ATFRIBVIESS F SFH"7S RING NUMAE RS 

AL START s20000 ENDS200F F SivEsS 100 
ATIRYBUTtSS EP USEN°S RING NUMER 

ak START «30000 ENDS301FF SIZE= 200 
ATIRIKUTES= CPCSU USERS KING NUMBLER= 

a6 START SaC00U END=6E DOF SIZES 2FDEO 
ATTRIBUTESS PC USER°S KING NUMBE He 

as START sa00000 tNNSG00 3F SI/Es ao 
&ATTRIKUTES= CS USERS KING NUMHERS 

AN START£Sa20000 END ZLOO0SF SIiZE= 66 
ATTIRIBUTESS PSU USER°S RING NUMRERS 

LOBUPNS: (SYSTEM EXTENSTUNS) 

Z210a8R SiIaART= 5501 

Z1UaKa SiaRf=s SFAG 

Z7XDEFM STAKTs TODA 

OVLYCT STARTS 7EFE 

¥VibCD StakTs a43e 


0 
VIRTUAL 
1 
VIRTUAL 
é 
VIR DUAL 
i 
VI Tar 
i 
VIRTUAL 
2 


RESUILA* Ss CPEKPANENILY RESIOENT EXECUTEVE CLIVE RLAYS) 


o1Xx 
O1uck 
tixPCLe 
CHyteE Mo 
nukuuZ 
WYCRR 
QZACCK 


SYSTEM SY“BUL 


Z3SEREC 


SIARI S4énep 
Slakile520H 
SIARTS91I70 
SPaRT Sowa 
Si aR I SHAOE 
SIAKTSAD4Q 
$141 54360 


1AULFE 3 


OP 


START#3102 


LOCATIONS 
Ziusua 
71084 
Z™BSPUr 
iMSwAaP 
44K SSD 
ZTE ND 
/XMCLX 
duseil 
ZXS¢ UF 
div1S8 
ZYUPE & 
ZY RIK 
ZXIRML 
XM OMGR 
RKCK LT 
XADTAW 
xTu 
X1LSPRS 
XXPUST 
XXTKAS 
XUNGIFT 
XXRE ia 
XXSTSK 
XXAVE 
KRESS 


ah mk me oH Ok Tf 8 otk AO He te ak me Ae AR tl Ok RO 


6 a 
¢ UURPCLE STARIZRFRH , 
e WXGRIE STANISH777 , 
6 ULOUMS Sart sneae , 
e (WERSS StaRTs934a— 
oe UYET SIARTZRGI7? 
o UZxXEFR START3E90a00 
e550 ZXSIMK S 116E 
1097 Z2{aTim = 1110 
AFE 2MKSVU B RI 
aFe ZMRLIU & AFS 
AFR Zynane = 1137 
FOS flute & F0A 
tat 7MSSG 3S th 3a 
icc JeCHE = 10TH 
17aKn ARES] B 2065 
Ipcc ZXiwt & 1244 
eet fY¥CLF3 & 2220 
216 “7¥SM2 ®& 213n 
1FuA KuDAIA = 0 
Aan x4 GET = HOH 
C2C KRLRCT = CTe 
CCF XX}®K 3 CF2 
pac KiUIMk w FIA 
1160 NMWAIT 2&2 1L1F3 
L3F3 XXTEHM & LdEA 
Lé8A RUAMGR & L7Ab 
1807 XOVMGR = 1986C 
tRTF XxSIu 8 1€a¢ 
1066 XxXMCL & [8H 
1€¢3 XXUDQ 8 LEDS 
tF SC XXMAX © 18 AE 
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OULF 

apes 
UXPCL $ 
OK IND 
OY ASF 

uZaVvRe 
uyYCKPT 


ZXVLD 
Z2MHS Vi) 
2MRSPI) 
ZMRL IN 
ZIVERP 
ZMRIWN 
é2xSPRaQ 
PAC 
“X1IPSI 
ZKUStH 
ZYFM 
zysm™ 
XYCS 
XM ORIN 
XKMYCP 
XXTSIK 
X{046ER 
¥xOU 
XXSE" 
KUL 
RUEKRS 
XXTSKK 
XXGRPR 
XXTKML 
XXC LAT 


HLAS=S F406 


KHiaSz 


HlASS 2EEO0 
#FaSs 2€€ 00 


BASE 2EEOO 


Start 24 3¢ 35 
SAW TshaActb 
SfarRts9o0i 
SFaRTSaAS$3 
StARTS9777 
Slawfz9oaat 
Stax l sHan2 


11€e2 
#0n 
HO1 
AF 
113k 
HiF 
IHME 
it $¢ 
1444 
bie 
2354 
2toa 
FAH 
#C& 
C90 
dte 
TOKE 
1267 
1579 
184F 
ikéed 
Cae 
1613 
iFaa 
1F 76 


ew WF Oh 88 6 OO OO Ob OF Ut oe 9h 8 Ot Se on te Gk Ok Ok ee 


ses %&® += 3 8 8 


XxXC_8 
XXC_LHO 
MX*I1SC 
XZLLF® 
xZ28LCD 
xZXO€F 
XYOMS2 
xZKSUB 
XZUPAS 
xZCONC 
XXuUPEN 
XAXIWLT 
ZIvet 
ZiLp} 
Z1VOK 
Ztutv 
ZX PVC 
Z10tP 
ZIUXke 
ZIOLKA 
Zityve 
ZMGE IL 
ZD0ARUC 
ZORLDS 
ZXCNSR 
ZUCUtet 
ZX VE 
ZXULPR 
2X0 IR 
ZXGCH 
EZXULRGI 
ZXREW 
2xSel 
Zxvest 
@XXCA 
ZYUPE 2 
EXDF TP 
ZFRMIN 
EVEFS 
STTCHO 
SMONOI 
UVERLAYS 

utx 
OLULP 
OxPCLi 
ULUITMS 
UxXGRI2 
UXPCL $ 
uxXCGRP 
UXDE Ke 
UXHOUGP 
OXROGS 
OXOT# 1 
OXCIRYV 
UUERS I 
UIUIhe 
Oxstiel 
oxstua 
UXAVHI 
OXGACT 


amennnnrvrnennunnuaon tt 


XxC Cl 
XXCMEN 
XVEXT 
xZMaQ0 
XZ¥L 
XYOMD 
XZD3UB 
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—_ 
MEMPOOL DIRECTIVE 
Directive Names MEMPOOL 
A MEMPOOL directive defines a system memory pool, a bateh memory 
pool, an exclusive online memory pool, or & nonexclusive online 
memory pool. Each MEMPOOL directive describes only one type of 
memory oo0l, but a single MSMPOOL directive may describe more. than 
one exclusive online memory pool or more than one nonexclusive 
online memory pool. (You have the ootion of expressing the size of a 
memory pool symbolically by defining the size itn a VARIABLE 
directive. See the description of the VARIABLE directive elsewhere 
in this section). 
Format 18 
ae 

MEMPOOL S,.size [,P] 
Format 28 

ME MP OOL B,.size eP ) NC 

. C 

Format 3 


MEMPOOL JE,¢ pool_name, }size ,{XJCUICPICCICS] an 
rs poll_namei 


Argument Description Format ! 
s 


The letter S designates a system memory pool. The system memory pool 
must be defined in a separate MEMPOOL directive. If multiple MEMPOQOL —” 
directives have S as the first argument, only the last one is used. 


size 


The size argument is a positive integer that defines the number of 
words requested for the memory pool. To specify a pool size greater 
than 65535(10) words, use the double-word hexadecimal integer 
format (@eg., D7 10A00%). 


The size of the system pool may also be snoecified by an asterisk 
(*), in which case CLM will allacate to the system pool all memory 
remaining after MEMPOOL directives specifying explicit sizes have 
been processed. (Only ome pool may be defined with "** in its size 
field. Once any pool has been defined this way, no other pool may be 
so defined. 
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If a system memory pool is not defined in an explicit MEMPOOL 
directive, its size is set at 3K (3072) words. 


The size of pools must be in multiples of a certain number of words 
and will be rounded to the next highest multiple by CLM. For pool 
that are neither protected nor contained, the size of the increment 
is 32 words. For pools that are protected or contained the size of 
the increment depends on the Level 4 system in which they are to be 
used as shown in Table 5-3. If a pool that is protected or contained 
has the potential or extending into the batch pool, the increment 
for the batch pool must comoly with that of the extendable pool. 


Table 5-3. Increments for Memory Pools 


a Increment 
System (Nords) 


LAF 

(with !024K memory) 
LAP 

(with less than !1024K memory) 
SAF 


(with 64K memory) 
SAF 


(with less than 64K memory) 


a 
Memory poo] protection/containnent requires 


that the Level $ central processor possesses a 
memory management unit. 


Suggestions for calculating the sizes of memory cools are given 
after the funettonal description of the MEMPOOL directive. 


P 


The letter P specifies that the pool is protected: t.e., users of 
other non-overlapping memory pools are prevented from writing into 
it. If the argument is omitted the pool is not protected. If the 
pool being protected is the system pool, the executive code and the 
system data structures are srotected along with the system pool. If 
the system being configured does not have the MMU, this option is 
not effective, and a warning diagnostic is issued. 


Argument Description Format 2% 
B° 
The letter B designates a batch memory pool. A batch memory pool can 


be specified only once, in a separate MEMPOOL directive. [f two or 
more MEMPOOL directives have B as a first argument, an error occurs, 
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size 
Same as for rormat !. 
? 


Same as for Format 2. F 


EF] 


| 


The letter C specifies that the pool is containeds i.e., users of 
the pool are prevented from writing outside of it. The letters NC 
specify that the pool is not contained. The default for batch is 
contained. [If the system being configured does not have an MMU, no 
pool may be contained and non=containment is the default, 


Argument Description Format 33 


E 
null 


E indicates an exclusive (non-overlapping) online memory oool. A 
MEMPOOL directive that has © as its first argument defines one or 
more exclusive online memory pools. Even if your MEMPOOL directive 
defines nore than one exclusive online memory onol, you need to 
specify — only once (as the first argument). See Example 5. All 
exclusive online memory pools defined in all MEMPOOL directives with 
Eas their first argument constitute a pool set. 


A null (no entry) first argument indicates a nonexclusive 
(potentially overlapping) online memory pool. A YEMPOOL directive 
with a null first argument defines one or more nonexclusive online 
memory pools. 


Sach of these nool sets is an alternative definition of the same 
physical area of memory. All pools defined by a single MEMPOOL 
Jirective must be either exclusive or nonexclusive. 


2o00ol_nane 


The 2=character ASCII name that uniquely identifies each exclusive 
and nonexclusive online memory pool. The pooluname is used in CG 
(create jgrous) and SG (spawn group) commands and itn SCRGRP and 
S$SPURP macro calls. 


If tne sool._name begins with a decimal digit, the pooliname argument 
must de surrounded by apostrophes (e.j., 71A%). 


A pooliname argument should not be tncluded in a MEMPOOL directive 
for a system memory pool or a batch memory pool. The omission of the 
so0ol_name arjument in these cases must be signified by a comma. 


NOTE: At login you can (1) specify the two character identification 
of the memory pool, or (2) specify a single character and 
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accent the second character assigned by the facility, or (3) 
omit the pool identification and accept a two-character 
identification whose first character is L. 


It you login by method (2), all online memory pools to be used 
by the login facility must have the same first character in 
their pool name arguments. This shared first character should 
not be assigned to any other memory pool. In addition, tt ts 
advisable to assign second characters starting with digits 0 
through 9 (in order), then letters A through Z (in order)? 
this practice will optimize the effictlency of the algorithm 
used by the system’s logic facility when it searches for an 
available aemory pool. 


You can login by method (3) in the same way as for (2) except 
that the first character must be L. 


If you login by nethods (2) or (3), you should define at least 
as many memory pools as tne number of users who may 
consurrently gain access to the system, 


size 


The description of the size argument for Format ! also applies to 
Format 3. [f an asterisk Is not used to define the size of the 
systen pool, Lt may be used to define the size of an exclusive or a 
wonexclusive online memory »ool. [In this case the pool size ts 
calculated by CLM. CLW will allocate to this pool all memory 
remaining after MEMPOOL with explicit sizes have heen processed. 
Ince the size of an exclusive pool has been defined with an 
asterisk, no subsequent pool may have its size defined by an 
asterisk. Once the size of a nonexclusive pool has been defined with 
an asterisk, no more pools may be defined on that directive line. A 
subsequent pool directive nay define the size of a nonexclusive pool 
with an asterisk if the pool is the last pool defined by that 
directive. The size of an exclusive pool may he defined with an 
asterisk if the size of a nonexclusive? pool has been defined with an 
asterisk. 


onol_name! 


This option allows the user to refer to 32 given pool by two (or 
More) names. Pool _namel is the name of a pool specified by a 
orevious MEMPOOL directives pool_name is the new name. The 
attri»utes of the pool are specified by the original directive and 
cannot be changed by subsequent directives that use this option. 


CX] 


The letter X indicates that the online naol can he extended into the 
batch pool area. If a memory request cannot be satisfied with {in the 
Jefined size of the online s00l, the contents of the batch pool are 
rolled out of memory. [f X ils omitted, the online pool is not 
extendable. [If the contents of the hatch pool are to he rolled out 
of memory upon a SSPB (suspend batch) operator command, at least 
online must be defined with an X argument. 
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(u) 


The letter U specifies that groups using this pxl run in the 
unprivileged mode. Groups running in the unprivileged mode may not 
execute privileged instructions and will trav if a privileged 
instruction is attempted. The default is orivileged. 


(Pj 
Same as for Format i. 
{Cc} 


Same as for Format 2, except that for pools defined by Format 3 the 
Jgefault is not contained. 


{3} 


The letter S specifies serial usage of the nool? i.e., only one 
group at a time can use it. An attemot to create a second group 
using a serial usage onol results in an error return and the second 
group is not created. If this argument is omitted, the onol can be 
used by more than one grouo at a time. 


Funetional Descriptions 


Each WEMPOOL directive causes a pool descriptor list to be created. 
Later, after the memory requirements of the system and its 
extensions are known, each sool set is checked to ascertain whether 
it can fit into the remaining available space. If any element or 
pool set is too large, an error occurs. 


The Configuration Load Manajyer creates a file named ROLLOUT under 
the SID directory of the bootstrap volume if a batch memory or01 is 
defined and at least one online memory pool definition includes an X 
argunent. If a ROLLOUT file is to be created on a bhootstrao 
diskette, {t is usually necessary to jelete unneeded elements from 
the Oootstras diskette (“ZSYSO0) and then copy the remaining 
contents of this diskette to a backuo volume (where the remaining 
contents will be consolidated into a consecutive area). This 
technique will provide the largest possible consecutive area of 
unused space on the backup volume. Using this backup volune as the 
bootstrap volume, you can ootimize the possibility of successful 
creation of a ROLLOUT file large enough to accommodate the hatch 
memory pool. 


Tne following discussion of the protect and contain attributes 
applies only to a system having an MMU. The system pool nay ve 
protected or not. It may not be contained. The batch pool may he 
contained or not. It may be protected or nots but if it is 
orotacted, it will be srotected only from those pools that have no 
potential for extending into te batch pool, 


All other exclusive nonextendable pools may he protected, or 
contained, or orotected and contained, or neither protected nor 
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contalued. An exclusive pool that is extendable may also be 
contained. However, when such a pool is defined, the system does not 
prevent the user from accidentally writing into the batch pool area 
before the bateh program is rolled out. 


An exclusive pool that is extendable nay also be protected. [f such 
a pool extends into the batch pool area, the part in the datch area 
is protected only if there are no other extendable sools. 


The protect and contain attributes apply to all nonexclusive pools 
collectively. If any nonexclusive pool is protected or contained, 
then the set of nonexclusive pools have the same attribute(s). 
Nonexlusive pools may not be {ndividually contained or protected 
from zach other. A protected nonexclusive pool, therefore, is 
protacted from exclusive pools or from the batch pool overwriting 
its space. [t is not protected from other nonexclusive pools 
Overwriting its space. 


Guidelines for Calculating System Pool Memory Size: 


The following tables provide guidance itn calculating the size of the 
system memory pool. 


Table 5-4 lists the number of words of resident code required for 
various system components? Table 5-4 also lists the number of 
sharadle and/or exclusive filles that are used. 


Table 5-5 Lists formulas that can be used to calculate file memory 
space. 


Table 5-4 describes memory requirements for various system control 
structures. 


Table 5-7 describes memory reauirements for elements in online or 
batch memory pools. 


Table 5-8 describes memory requirements for the Message Facility and 
Checkpoint/Restart (describes in the System Concepts manual). 


The user is advised that the system memory pool must be large enough 
to handle the “worst case* situation. To compensate for pool 
frajmentation, increase the total pool size by at least 10 percent. 
The pool size must be a multiple of 32 words. 
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Table 5-4, Resident Code Required for System Components 


All sy stem components not listed below (and not also the subject of 
@ separate release bulletin) are less than 290 words, 


s Resident 
Comoonent Code 


Sharable Files Exclusive Files 


Access Control 
Utilities 


Delete Access 
Control 


Delete Common 
Access Control 


List Access 
Control 


List Common 
Access Control 


Set Access 
Centrol 


Set Common 
Access Control 


BU_COJUVERT Input file Qutput file 


Check Mass 
Storage Volume 


Compare 


Input file 
Ouptut file 


Compare ASCII Input file 


Quptut file 


Copy Input file Output file 


Commercial 
Instruction 
Simulator 


Create 
Directory 


Create File 


Create Index 
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Table 5-4 (Cont). Resident Code Required for System Components 


Resident 
Component Code Sharable Exclusive Files 


Create Mailbox 


ereate Volume 


Jata exchange 
Jtilities 


Compare Vata 
Sxchange 


Copy Jata 
Exchange 


vreate Volume 
Jata zxchange 


rile Cyange 
Data exchange 


List Jata 
Sxchanje 


vgebuz (sD) 


Jedug 
(Multi-User) 


Quick sreak~ 
a0int 
Processing 


Deferred Print/ 
eunach 


Jelete 
Jtirectory 


Jeleteae File 


10,534 


(system 
pool) 


1,500 
(user pool) 


3,750 
(system 
pool + 
user= 
specifiad 
size of 
quick 
menory 
buffers 


1,055 


790 


826 


Qutput File 


{MDUMP etc.) 


Inout file 
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Output Volume 


Inout File 
Qutput File 


Inout file 
Output File 


Qutut ftle 


Inout file 


Input file 
Qutout file 
Work file 


Work File(s) 
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Table 5=4 (Cont). Resident Code Required for System Comoonents 


Delete Index 


Display 
rormatting 
Create 

Print 

VDAM 

¥FORMS command 


DPEDIT 


zditor 


Export 


Pile change 


rile Dump 


Get file 
38t Quota 
Interactive 
System 
definition 
(M4_SYSDEF 


Linker 


List Creation 
Jate 


List Names 


4,140 
1,406 
7,663 
592 


SAP 7,345 
LAr 7,748 


7,011 


(+ 2KW ser 
user) 


2,300 


1,354 
1,625 

(+ 3008/7 
user) 
735 
5.700 
4,777 


(+ 4KW Get 
Memory) 


10,750 
(+ default 
Get Memory 
of 2K) 


2,990 


4.982 


FORMS>VDAM_FORM_O! 


Input file 
Output file 


Input files 
Qutput files 


i Input file 


Gutput file 


Input files 


Input file 


Inout file 


Output file 
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Table 5=<4 (Cont). Resident Code Required for System Comoonents 


Resident 
Conpone nt Code Sharable Exclusive Files 


Qutput file 


List Tape 
Contents 


1,417 Input file 


Listener 2,231 Input file 


Load Index 1,885 Qutput file 


Modify File 1,030 


Patch 10,299 Input ftle 


Qutput file 


Prime Index 5,790 Qutput file 


Print 1,507 Input file 


Print/eunch 
Jaemon 


6,800 Input file 


Output file 


Queue Resort 1.772 Input file Qutout file 


1,025 
3,900 


Rename 


Report Queue 
Maintenance 


Inout file 
Qutput file 


Restore 3,800 
(* 2,5K 
Get 


Memory ) 


Input file 
Gutput file 

+ {| temporary 
work file 


Reorjganize 
Indexed rile 


Inout file 
Work file 


Save 


Inout file Qutput file 
+ | temporary 


work file 


Memory ) 


Set Terminal 
Characteristics 


2,135 


SIP sinulator 
(Double) 


2,000 


SIP Simulator 600 
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Table 5-4 (Cont). Resident Code Required for System Components 


Resident 
eee Code Sharable Exclusive Files 


Tape 
Positioning 


TCLS 

TCLe 

Uns pool 

Nalk Subtree 
ZXDEFM 


(Defective 
“Memory Trao 


2,900 


See Note 


Input file 


5,700 Input files 


800 
30 


nandler)$sli ZXPRF] 262 


( Power 
Resumption 
Facility) 


NOTE *s The wetual earnbee of words ceguited by the TCLP to verform 


transaction processing depends on the numper of concurrent 
users and the mix of transactions they are running. Refer to 


Appendix rf in the 


for the formulas use 
requirements. 


Transaction Control Language Facili manual 
ad to calculate the ICP memory 


Table 5-5. Formats for Calculating File Memory Space 


File Reserved 
=xclusively 


Sharaole Files 


Memory Required for 
System Memory Pool 
(in words ) 


Memory Required for 


Online (User) memory 
Pool (in words) 


Memory Required for 
System Memory Pool 
(in words) 


Memory Required for 
Qnline (User) Yemory 
Pool (in words) 
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96 + (M x 32) where Mis 


the number of buffers ca 
44 # (M x CI size 
2 

where M is the number of 
buffers ; sae 
96 + M(32 + CI size 

2 
where M is the number of 
buffers Se ney de 

wee” 


Table 5-5 (Cont). Formats for Calculating File Memory Space 


Memory Requirements in a MOD 400 LAF System oo 


File Reserved Memory Required for 64 + (M x 32) where M ts 
Exclusively System Memory Pool the number of buffers 
(in words) 


Memory Required for 32 + (M x CI size) 

Online (User) Memory y} 

POOl (in words) where M {s the number of 
buffers 


Sharaole eiles Memory Required for 64 * M(32 + CI size) 
System Memory Pool 2 
(in words) where M is the number of 


buffers 


Memory Required for 32 
Qnline (User) Memory 
Pool <in words) 


CI size = control interval size 


NOTE? For all system commands, the number of buffers per file is one 
(unless the user has acted to change this value). 


The control [tnterval size for each command {s 512 (unless the 
user has allocated a file with a different control interval 
size). 
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Table 5=<6. Memory Requirements for System Control Structures 


Word Size 
Element SAF LAF Qecurrences Product 


The number and size of the various control structures will vary 
depending on the tnstallation’s processing requirements. For each 
item in the “Element” column multiply the word size (using the SAF 
or LAr figure, as appropriate) by the number of estimated 
occurrences to obtain a “products } then add all the produc ts. 


Bateh SCB (includes LET, CRT 
for LFT#LRAN < 47(SAF) 
and LFN+LRN < 28(LAF) 
for every LFN+LRN above 
these limits, add 1 (SAfr) 
or 2 (LAF) words. 


Batch TCB’s (includes lead 
task, execution commands) 
Nitnout Sip 
Nits SIP 


Saten Request Blocks Te a a ae 


ROoliout Cavabliiity 347 447 Qor ! 
(Rollout Pile and Code) 


Fach Active Disk Directory 
aad rile (include bound 
unit as files) 


Per Conmand_Input/User_Input 
rile 

Operator Terminal (MDC) 

Disk(la) 

TTY (MLCPY 

PRue CR 


Per Jser Disk File Wi th 
Concurrency of “Sherable® 
or per "Device File"*(b) 
Management (suffer size) 
Disk(a) 

PR, PRU 
cRy KSR 


CI+32 CI+32 
As > 


Per Ke tive File Ca) 
(butter control block) 


Ser Bound. unit 
(rile overhead = sharable 
or overlays) 
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Per Sharable Bound Unit 
SBUS (SAF) = 18 + 
S(number of overlays) + 
4(number of EDEFed symbols) 
* code size 


Concurrently Outstanding 
Mount Volume Requests 
eased Trap Save Areas 

_for Each Task 


Total Pool Size Without 
Fragmentation (sum of 
Product column} 


rragmentation Allowance 
(10 gercent of item 
immediately above) 


Group control blocx 

Logical file table 

Logical resource table 

Task control block 

Sclentific Instruction Processor 
Disk control interval 


Indexed sequential files nust be counted as two files. 


b 


Double the word size value if the "device file” is bidirectional 
and ouffered. 


Juidelines for Calculating Online and Batch Memory Pool Size. 


The following table provides guidance in calculating the size of the 
online pools and the batch ool. 
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Table 5=7. Memory Requirements for Elements in Online or Batch 
Memory Pools 


Word Size 


SAF LAP Occurrences 
The number and size of various elements will vary depending on the 
installation’s processing requirements. For each item in the 
4“Elements"® column, multiply the word size (using the SAF or LAF 
figure, as appropriate) by the number of estimated occurrences to 
obtain a "Product"s then add all the products. 


128 


Product 


Element 


MEMPOOL 


3C3 (includes LET, LRT) (a) 
for LFEN*LRN < 47 (SAF). 
and LFN*LRN < 28 (LAF) 
For every LFN+LRN above 
these limits, add § (SAF) 
or 2 (LAF) words. 


TCB’s (includes lead task and 
execution commands) (a) 
witnout SIP 

With SIP 


GROUP REQUEST BLOCKS( a) 


Work Soace for Commands 
Execution Commands 


Commands From Interactive 
Terminal 


TRB (exclude lead task, 
inéelude execution 
commands) 


Per Command _Inout/User_Input 
rile 
Device 
Disx/Tape 


Per Error Qut/User_Qut File 
NonJisk 
Disk 


rer Jser File (FCB) 


Per User Disk File With 
Concurrency of “Exclusive 
Under Control of Data 
Management(b) (buffer size) 


rer associate File 
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JTaole 5=7 (Cont). Memory Requirements for eee in a or 


Batch See Pools 
a | Word size 


a 


Per Jser rile Under Sap deer File er Control. | 
Uf storage Management 


Per Nonsharadle Bound Unit 
NSBUS (SAP) = 18 + 
S(number of overlays) * 
4(number of EDEFed sya) 
+ code size 


Per Yonsharable Bound 
Unit (cont) 
NS3JUS (LAF) 2 25 + 
6(number of overlays) + 
5S(number of EDEFed symbols) 
+ code size 


Any Bound Unit With Show 
Load Section 


User requested Memory 


Total Panel Size Without 
Fragmentation (sum of 
Product column) 


Fragementation Allowance 
(lO percent of item 
Imnedi{ately above) 


Grouo control block 

Logical file table 

Logical resource table 

Task control block 

Scientific Instruction Processor 
Task request dlock 

rile eontrol block 

Disk control interval 


| sar LAF | occurrences _ 


Hida 


When calculating the size of the batch memory pool, do not include 
this item since, in the case of batch processing, it aopears in the 
system nemory pool (see Table 5-6). 


ie) 


Indexed sequential files must be counted as two files. 
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Table 5=8. Memory Requirenents for Message Facility and 
Checkpoint/Restart 


User System 
Component Pool Pool Oceurrences 


Message racility 


weer ce 


MEMPOOL 


System overhead 


ror each task group using 
Messaje facility. 


ror each mailbox 


ror each mailbox with 
disk queuing 


vkeckpoint/Restart 


Permanently allocated 
(for each grouo using 
checkpoint/Restart) 


Dynamically used during 
every Checkpoint (For 
more than 2 tasks in 
the group, add !92 for 
each additional task) 


Dynamically used during 
every Restart 


zxample it 


MEMPQOL S,,4096 


In this example, a system memory pool of 4096 words is defined. 
Secause a system memory pool is being defined, no pool_name argument —~ 
is specified, but the second comma indicates omission of the 
argument. 


cxample 23 
MEMPOOL B,,12288 


In this example, a batch memory pool of 12,238 words is defined. 
decause a batch memory pool is being defined, no pool_name argument 
is specified, but the second comma indicates omission of the 
arjument. Tne batch pool is implicitly contained unless the s00l 
size is followed by *,NC", which specifies not contained. 
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Sxample 3: 


MEMPOOL E,A3,12768,,CD,1024,X 
MEMPOOL E,Ee,2048 


In this example, three exclusive online memory pools are defined. 
The three dools constitute the set of exclusive online memory sools. 
The first MEMPOUL directive defines two exclusive online memory 
pools: (t) The first, whose pool name is AB, comprises 12,768 
wordst it cannot dynamically extemd into the batch memory pool 
because argument 4 of the MEWPOOL directive is mull. (2) The second, 
whose pool name is CD, comorises 1024 words’ it can dynamically 
axtend (if necessary) into the batch memory pool because argument 7 
ts X, indicating rollout. The second MEMPOOL directive defines an 
exclusive online memory pool named Er. This memory pool comprises 
2048 words. It cannot dynamically extend into the batch memory oaoo0l 
because argument 4 is null. 


Zxanple 4% 


MEMPOOL ,XY,512,,UV.* 
MEMPOOL ,WX,#,X 


In this @xample, three acnexclusive Online memory pools are defined 
(argument | tn each ME¥POOL directive is null). Each MEMPOOL 
directive defines 3a pool set; the first pool set comprises two 
2001s, the second pool set comprises one pool. Because twn onol sets 
are .onexclusive, they define the same ohysical area of memory 
(1.4., they overlan). Any contention for soace within this area of 
memory will be resolved by the syste.n, 


The first MEYPOOL directive defines two nonexclusive online nemory 
a00lst (1) The first. whose pool name ts XY, comprises 512 words? 
it cannot dynamically extend into the batch memory pool because 
argument 4 of the WEMPOOL directive ts null. (2) The second, whose 
X00l name is UV, occuoles all memory remaining after the pools with 
explicit sizes have been allocated (because argument 6 is an 
asterisk)% pool because argument 7 1s null. The second MEMPOOL 
Jirective jtefines a nonexclusive enline nemory cool area named AX, 
ft can dynamically extend (if necessary) into the batch memory oool 
Carjunent 4 is X, indicating rollout). 


The diagram below (not drawn to scale) indicates the memory pools 
establisned by the MEMPOOL directives in examples |! through 4. Note 
that the two sets of nonexclusive online memory sools define the 
same ohysical area of Nemory. 


OPERATING HIGH 
SYSTEM MEMORY 


ee 
POOL XY POOL UV 
POOL WX 


ae ee” wee, eee | et ene | eee 
SYSTEM aad POOL AB POOL CO POOL EF 


nee, tan” 
8SATCH MEMORY 
POOL 


EXCLUSIVE POOL NONEXCLUSIVE POOL 
AREA AREA 
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VCVITVYUL 


Example 5% 
MEMPOOL E,JJ,4096,PCUSKX,RAR,8000, SU 


This example defines two memory poolss one named JJ, the other AR. 
Both pools are exclusive. The attributes for pool JJ are designated 
by the two arguments that follow the entry JJ. The first designates 
a size of 4096 words. The second specifies that the pool is 
9rotected, contained, and unpriviledged, that only one group can use 
it at a time (serial usage), and that it can extend into the batch 
9001 area. Note that the elements of this argument can be entered in 
any order, and that no commas are inserted between elements. 


Pool 3R is assigned 8000 words of memory. It is neither protected, 
nor contained, nor expandable: it is unoriviledged and reautres 
serial usage. : 


Example 6s 


MEMPOOL  E, <K,4000,PS 


ME MP OOL Bh aXKo gM, KK 


This example filustrates the use of the renames option. Pool KK is 
declared first. The second directive specifies alternate names for 
this pool. Pools LL and MM have the same attributes as KK. Both are 
protected since KK is protected. All three names define the same 
4000-word area in memory. SInce KK is serial usage, LL and “M are 
serial usage also. The serial usage attribute is a function of the 
pool name. Since these three pool names describe the same memory 
xool, three grouos can possibly use tne pool area LL, and a group 
using YM could all be active at the same time. But, for examole, 
two groups using the pool name KK could not vooth be active at the 
sane time. 
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QUIT DIRECTIVE 


Directive Name: QUIT 


The QUIT directive must be the last directive in the file of CLM 
directives. 


Format t 


QUIT [VER] 


Argument Descriptions 


(VER) 


The VER argument causes the version (date and time created) of each 
Configuration Load Manager module used to be typed out at the 
Operator terminal. The format of the tyneout is shown below under 
the example, 


FunctLonal Description: 


The QUIT directive causes the Configuration Load Manager to cease 
reading CLM directives and to begin its loading ohase. The following 
actions occur! 


1, Any required final data structures are created. 


If a communications environment nas been defined, it is 
initialized. 


Bound units (if any) identified tn LDBU directives are loaded 
into the system area of memory. 


System overlays (f{f any) identified {tn RESOLA directives are 
loaded {nto the system area of nemory. 


Memory pool descriptors are created, based on the contents of 
MEMPOOL directives. Sach memory pool set is checked to 
ascertain whether {t can fit into available memory space. 


The Configuration Load Manager terminates. 
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QUI VER 


This example causes 


CLM directives, type out the version identifier of each CLM module 


used, and enter its 
below, 


($S) 
($$) 
($3) 
($$) 
($$) 
($S) 
($$) 
($3) 
($3) 
($5) 
($$) 
($$) 


the Configuration Load Manager to cease reading 


leading phase. The typeout might appear as shown 


CLMVAR 80/10/03/0836 
CLMST! 980/09/14/0903 
CLAST2 80/10/02/0808 
CLMDEV 8071071071206 
CLMMMU 80/08/17/1021 
CLMCOM 80/11/08/71539 
CLMCM2 80/10/15/2105 
CLMCMi 80/10/15/2104 
CLMCM3 80/10/71572106 
CLMCM4 80/10/15/2107 
CLMFLT 80/10/02/0811 
CLM 80/09721/0750 COMPLETED 
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RESOLA 


RESOLA DIRECTIVE 


Directive Name? RESOLA 


The RESOLA directive tdentifies one or more system overlays that are 
to be loaded tnto the system area of memory, where they will remain 
resident for the duration of the configured system. 


RESOLA overlay_namef{ ,overlay_name]... 


Argument Deseription: 
over lay_name 


A string of up to six ASCII characters that identify a system 
overlay that is to be made resident for the duration of the 
configured system. Appendix B identifies the system overlays that 
can oe specified {n this argument and the funtion(s) provided by 
each one. 


Functional Deseriptions 


Rach RESOLA directive adds one or more system overlay names to a 
list of resident system overlays. During the Configuration Load 
Manager’s loading ohase, each name on the list is compared with a 
table of system overlay names. A match causes the indicated system 
overlay to be loaded {nto tre system area of memory. 


If no match occurs, an error ts tndicated. [f one overlay name on a 
RESOLA directive causes an error, all other correctly specified 
overlays in the same directive can nevertheless be loaded. 
Examples 

RESOLA OYDMT,OQZTSUB,OZTUTL 
This example identifies three system overlays (these three are used 
for orocessing tagnetic tave files) that will be loaded into the 


systen area of memory, where they will remain resident for the 
duration of the configured system. 
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RLOCK 


RLOCK DIRECTIVE 


Directive Namet RLOCK 


The RLOCK directive defines a pool of structures to be used by data 
Management when record locking is reauested at file reservation 
time. The size of the pool determines the total number of records 
that may be locked at one time. 


One structure is used for each record to be locked. The size of each 
structure is six words for SAF and eight words for LAF. These 
structures are reusable after records become unlocked. The RLOCK 
directive must be included if the record lock facility is to be 
used. If more than one RLOCK directive is given, the last one takes 
effect. 


Format: —/ 


RLOCK fintt], fine] ,{ max] 


Argument Descriptions 
Cinit3 


Specifies the number of initial record lock structures. The default 
fs 1/5. 


Cine) 


Specifies the number of record lock structures that can be added at 
one time. The default is 5. 


{max j 

Specifies the total number of record lock structures permitted. The — 
default {s 30. An entry of O signifies that the total number of lock 
structures is unlimited. [f the initial size or the increment size 


is greater than the maximum size, the following CLM message is 
generated. 


133A QLOCK ARGUMENTS INCONSISTENT WITH EACH OTHER 
NOTES # 


1, The initial record lock pool is allocated in system memory 
at the time of the first record lock request. 


2. The sizes of all three arguments are rounded up so that 


the amount of a memory allocated is a multiple of 32 words 
minus 2 for SAF, or 32 words ninus 3 for LAF. 
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Functional Descriptions 


The record lock facility of the file system provides multi-user 
interferance protection for records within shared disk files. For a 
detailed description of this facility see the Data File 
Organizations and Formats manual. This facility requires that a 
pool of record lock structures be created by means of .the RLOCK 
directive. Because record lock entries are used and surrendered 
dynamically, the RLOCK cool need contain only enough entries to 
service the naximum number 9f records that will be locked at the 
Same time. The following procedure shows how to calculate the size 


of the record lock pool for a system where a number Of users perform 
simultaneous transactions. 


Assume that each transaction consists of an undate of three records. 
The file system will lock the control intervals (CI%s) in which the 
three records reside, and for indexed sequential files {it will also 
lock the record oreceding each of the accessed records. Thus, a 
maxiaum of six CI%s may be locked. However, two consecutive records 
are usually in the same CIt therefore three locked Ci’s is a good 
approximation for an indexed sequential file and the exact value for 
other file organizations. 


Assune that ten users perform transactions but never more than four 
users access the data base simultaneously. For these assumptions, 
the initial number of record necks ts 12 (4 x 3) and the natural 
foacrement is 3. 


The accuracy of these estimates may be improved by taking into 
account the memory managemant features. Record lock entries are 
allocated in system memory, and system memory ts obtained in blocks. 
(A multiple of 32 minus 2 words for SAF! a multiple of 32 minus 3 
words for LAF). In a SAF environmant, record lock entries are six 
words long. Therefore, for SAF, better estimates for initial and 
tnerentent values would be 15 and 5. 


Example !: RLOCK 
tnit = 15 
inc = 5 
max = 30 
Example 2% RLOCK ,,45 
init 2 15 
inc = 5 
max 2 45 
Example 3 RL(IXCK 45,,45 
init = 45 


inc = 5 
max 2 45 Error because 45+*5>45 
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RLOCK 


Example 48 RL(IXK 45,0,45 


init = 45 
inc = 0 
max = 45 


Example 5% RLOCK 20,5,60 
RLOCK ,4 


init # {5 
inc = 4 
max = 30 


Example 6? RLOCK 20,5,60 


RLOCK 20,4,60 
init = 20 
ine = 4 
max = 60 
Example 7# RLOCK ,,0 


init # 15 
inc # 5 


max ® unlimited 


ee 4 
No error 
Because the last RLOCK 
directive is the effective 
ONG. 
wet” 
—/ 
ee 


5-44 


SYS_ 


SYS_ DIRECTIVE 


Directive Namet SYS 


. The SYS directive defines a number of system variables. 


Format? 
SsIp 
; DSIP 
SYS (Hz21,(scan-cyele), CIP sColan}],(tsal,CirbJ(,,£) 
SCIP 
nu tl 


Argument Descriptions: 
CH2) 


Specifies the line frequency at which the system’s realtime clock 
Operates. Possible values are 60 (for 40 Hz) and 50 (for 50Hz). 
Model 20%s and 30%s should he configured with a value of 50 if the 
line frequency is 50 Hz, and 60 if the line freauency is 460 Hz. 
Model 40%s5 and 50%s should always be configured with a value of 40, 
The default value {fs 60 (the U.S. standard). 


{scan_cycle]) 


Specifies the time, in milliseconds, between interrupts by the 
system’s real-time clock. The default value ts 50 (milifseconds). 


The following values (in milliseconds) are possible for scan cycle. 


50 Hz Line 60 Hz Line 
10 8 
20 16 
50 Fb 
ore) 33 
50 
100 


Millisecond {intervals in cyclic clock request blocks should be 
expressed (Lf possible) itn multiples of the scan_cycle. This 
practice ensures long~term accuracy Of event synchchronization. 
Qtherwise, the full deviation between the specified tnterval and the 
nearest scanicycle multiple is always realized. 
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SAS 


SSfe 
OSIPp 
CIP 

SoIP 
null 


Specifies,.that scientific instructions and/or commercial 
instructions will be used in applications. Commercial instructions 
are processed by the Model 47 or Model 57 Central Processor in 
configurations so equisped$’ otherwise, commercial instructions are 
processed by a software simulator (CIPSIM). Sclentific instructions 
are processed by the Scientific Instruction Processor if it is 
present? otherwise, scientific instructions are orocessed by the 
software simulator (SIPSIM). 


Note that in configurations with a Model 47 or Model 57 Central 
processor, the commercial extenston to the interrupt save area is 
automatically created for each oriority level except for those 
specified for this argument. The presence of a hardware Scientific 
Instruction Processor automatically creates the commercial and 
scientific extensions to the interrupt save area for each priority 
level exceot for those levels occupied by drivers, regardless of the 
Option specified for this argument. 


SSIP indicates that single-srecision scientific instructions are to 
be processed. If the hardware Scientific Instruction Processor is 
not present, the single=-precision SIP simulator (SIPSIM_SP) will 
automatically be loaded during the system startup. If the hardware 
Scientific Instruction Processor is present, it is used and the 
single=precision SIP simulator Is not loaded. (SSIP is permissible 
for use with BES 2xx FORTRAN programs and FORTRAN programs without 
double precision). 


QSIP indicates that double-orecision scientific instructions are to 
Se processed. If the hardware Scientific Instruction Processor is 
got present, the double-=preciston SIP simulator (SIPSIM) will 
automatically be leaded durina system startup. If the hardware 
Scientific Instruction Processor is present, it will be used and the 
double-preciston SIP simulator is not loaded. (DSIP is permissible 
for BES 203 == and later <= FORTRAN srograms). 


CIP indicates that commerctal instructions are to be orocessed. If 
the required central processor model {s not oresent, you must 
include an LOBU directive that identifies the commercial simulator 
(CiPSIM). If the required central processor nodel is opresent, it 
will he used and the Commercial simulator should not be identified 
in an LDBU directive. 


SCIP indicates that both selentific and commercial instructions are 
to be processed. If the hardware Scientific [nstruction Processor is 
not present, you must include an LDBU directive that identifies the 
Single-precision SIP simulator (SIPSIM_SP) or the double=precision 
SIP simulator (SIPSIM). If a Commercial Central Processor model is 
not present, you must include an LDBL directive that identifies the 
Commercial simulator (CIPSIM). If the hardware Scientific 
Instruction Processor and a commercial central orocessor are 
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present, they will be used and the SIP and commercial simulators 
should not be identified in LDBU directives. 


NOTE! [f both SIP and commercial simulators are used, the order af 
the LOBU directives governs the order in which the simulators 
process a trap to the single trap vector they share. The 
simulator identified in the Last LDO8U directive will process 
the trap first. 


null (no entry) tndicates that no scientific or commercial 
instructions are to be processed or that any reautred hardware 
Selentific Instruction Processor and/or a commercial central 
orocessor model is present and will be used. (Thus the corresponding 
Simulator is not used). 


[olan] 


Specifies the number of 31l2-word sysytem overlay areas to be 
created. The value for olan must be a decimal integer from 2 
through 99. The default value is Ii, indicating one Sl2-word area to 
be used for system overlays. 


(tsa] 


Specifies the number of trap save areas to be created in addition to 
the default number of 6 (system without communtcations), r 
systan with communications), or 8 (SAe system with communications}. 


The size of each acditional trao save area is the same as the size 
Of each of the default trap save areas (viz., 64 words in a SAF 
system and 104 words in a LAF system). 


You have the ontion of expressing this parameter symoolically by 
defiaing it with a VARIABL= directive. See the description of the 
VARIASLE directive elsewhere in this section. 


{ird]) 


Specifies the nmunber of intermediate request blocks to the created 
in attition to the default number of 20 for the system. Fach 
intermediate request Slock is 3 words tn a SAr systein and 13 words 
in a LAF system. 


You have the ootion of expressing this parameter symbolically by 


defining it with a VARIABLE directive. See descristion of the 
VARIABLE directive elsewher? in this section. 
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SAS 


@® [£3 
> 
@ Specifies that expanded error messages (text in addition to code) 


are to be issued. If this argument is omitted, only the error code ~~ 
is issued. 


Qnee this argument is specified, it remains in effect for the 
duration of the configured system, even 1f subsequent SYS directives 
appear with this argument null. 
This argument is not meaningful if the system 1s bootstranped from 
diskettes’ space limitations on diskette prevent the presence of the 
error message library file (EMLFILE). 
runctional Description: 
The SYS directive defines a number of system variables. If all of 
the SYS directives default values are accentable, it can be 
Omitted. These default values are summarized below, 
Hz - 60 Hz line frequency . —_, 
scan_cycle = 50 milliseconds 


SSIP/DSIP/CIP/SCIP —- null (no SIP simulator or commercial 
simulator required) 


Olan ~ | system overlay area 

tsa ~ 7 trap save areas 

irb ~ 20 intermediate request blocks 

—E~ error code only, no text 
If multiple SYS directives are specified, only the last one is 
effectivei exceptions? (1!) ali trap save areas and intermediate 
request blocks specified on all SYS directives are added to the 
system defaults of 7 and 20, respectively, and (2) if E is smecified 
in any SYS directive, expanded error messages (text in ardition to — 
code) will be issued. 
The size of the interrupt save area (and hence the size of the task 


control block, which includes the interrupt save area) depends on 
the Crd Model and SIP/CIP characteristics as shown in Table 5~9. 
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Table 5-9. Decision Table for Calculating TCS Size, Based on CPU CG 
Model and SIP/CIP Cnaracteristics i 


LTS a NEP EE 
noon a3, 33, on vate] | [ t tet tT Piet a de} Pe 
eee A le eee ees a) 
oc 


Medel 47 o¢ 57 
Muil acgument? 
SSIP ergument? 
D6IP argument? 


CIP argument? 


SCIP arqueent? Bere ear eee eae ee 


Resultant [SA Typet 


[Resultant 1A Type 
Beale 18a See ee te hee 4 


+ Model 49 and 59 HH 
registers 
+ CIP context et ee eae oe tepeie lil) 


+ ath conten CCORECCE GEER E CER EETS 


TCR Size, Sased on ISA Type 


‘ SAP Size LAF Size 
{SA Type (words) {words} 


Basic ISA Wet applicabie 
+ Registece : 96 
+ CIP Context 96 
+ SIP Context 128 
fncey meanings: ¥ - yes W-no X ~ ISA type 
. ‘The besic ISA ends with the Mt-~-cegiater save word. 


The ISA for Model 43, 47, S53. of $7 registers includes the basic ISA, save words for the 
M2=- through M?-cegisters, and save word(s} for the stack address register. 


« The CIP context Includes all eiements in item Zr plus the CiP-specific context area of 
2 words (SAF} ac 3 worde (LAP). 


- The SIP context inciudes 311 elements in item 3, plus the slP-specific context area of 
13 words. 


« Ali TCB sizes ace counded up to the neecese aultiple of 32 words. 


YQ Example: 


SY 


This 
that 


SYS ,25,SSIP 5 ,e0cE 


example defines the system variables as shown below. (Assume 
Only one SYS directive is used). 


The system line frequency is 60 Hz (default). 


The scam cycle of the system’s real-time clock is 25 
miliseconds. 


The single-precision SIP simulator (SIPSIM_SP) will be loaded 
to process scientific instructions, unless the hardware 
Scientific Instruction Processor is present. 

Pive system overlay areas will be created, 


Six trap save areas will be created (default if no 
communications). 


Twenty intermediate request blocks will be created (default). 


Error codes will be expanded to include message text. 
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VARTAJLE DIRECTIVE 


Directive Name? VARIABLE 


VARIABLE 


ve 


The VARIABLE directive defines a single-character symbolic 
expression (chosen from the letters A through Z) that may be 
specified in certain CLM directive statements. 


Variables can define values for the fields in the SYS directive 
representing additional trap save areas or intermediate request 
blocks, Or memory pool sizes tn a MEMPOOL directive. A variable must 
be defined by a VARIABLE directive before it can be specified in 
other CLM directives. 


Formats 


VARIABLE variablezexpression 


Argument Description: 


variable 


A single character designation, upper case Only, chosen from the 
letters A through Z. 


expression 


Any valid expression that defines the value of the varfable. 
Expression may equal any of the followings 


« 


eo 


An tnteger having a value between ~ 32747 and +32767. 


KSR (represents the total number 
finally configured using the KSR 


of \MC=-connected terminals 
value) 


CON (represents the total number of MDC-connected terminals 
finally configured with the CON value) 


TTY (represents the total number 
finally configured by DEVICE TTY 


VIP (represents the total number 
finally configured by DEVICE VIP 


ATD (Represents the total number 
Sy DEVICE ATID directives) 
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Of communications devices 
directives) 


of communications devices 
directives) 


of devices finally configured 


VARIABLE 


* 


t > 
« expression ad expression 
] * 


/ 


An arithmetic combination of two expressions (chosen from this 
list) using acdition (+), subtraction (=), multiplication (¥*) 
or division (4). The value of an expression ts always an 
integert all fractional values are truncated, not rounded. For 
example, 5/3 will be passed to the system as having a value of 
one (1). 


o Cexpresion (1)) 
expression, is to be evaluated before being combined with any 
other expression term. The expression is always evaluated by 
the system as an integers all fractional values are truncated, 
not rounded. For example, 5/3 will be passed to the system as 
having a value of i. At each step of the evaluation of an 
expression, fractional values are truncated, {.e., this is 
Strictly integer arithmetic. 


2 expression 


Specifies a signed value, plus or minus, for the expression. 
Note that “+*expression* has the same value as "expression". 


« X (where x is the name of an already defined variable) | 


Variables may be used when specifying the number of trap save areas 
and intermediate request blocks in a SYS directive, or the size of a 
memory pool in a MEMP.OL directive. Using a VARIABLE directive, you 
can assign symbolic values for these fields that will be 
subsequently resolved by the system, By specifying variables in SYS 
or MEMPOOL directives, the system builder creates a jyeneralized CLM 
file that may be used by several similar but not identical hardware 
configurations. F 


Example | 8 


VARIABLE A® TTY #3000 
MEMP.OOL ~ ,T1,A 
MEMPQOL S,,* 


Note that in all cases, a variable must be defined in the CLM file 
before it can be used in subsequent directives. The variable A has 
been defined to be equal to the total number of TTY terminals 
finally configured, multiplied by 3000. In the MEMPOOL directive, A 
represents the 3000 words of memory that will be reserved for each 
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.. TTY configured. The first WEMPOOL directive defines the name and 
size of the memory pool that has reserved 3000 words of memory for 
each TTY terminal. Tne second MEMPOOL directive allocates all 
remaining memory to the system memory pool. 


By defining memory pools with variables, the system builder can 
accurately account for as many or as few devices as are actually 
configured. He need not know the channel number assigned to each 
device, the memory pool size, or the number of devices actually 
configured. The system assigns these characteristics accurately and 
automatically. 


example 28 


* 


VARIABLE BeTTY*3 
VARIABLE C=TTY #2 
SYS .ee+0,8 


In this example, two variables have been defined for the trap save 
area and intermediate request block filelds in the SYS directive. C 
1s defined as the number of trap save areas that will be allocated 
for each TTY terminal, in addition to the default number. (The value 
of © equals twice the number of TTY terminals configured). C 
specifies tnat each terminal will have twp trap save areas in 
addition to the default mumber. B is defined in the SYS directive as 


the number of intermediate request blocks that will be allocated for 


each TTY terminal, in addition to the default number. (The value of 
3 a@quals three times the number of TTY terminals configured). 8 


specifies that each terminal will have 3 intermediate request blocks 


in addition to the default number. 
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Example 38 


Sample CLM File 


VARIABLE TaTTY+VIP 
i VARIABLE I=KSR+10 
SYS vesels losE 
DEVICE DSKO0,6,10,X7400 
DEVICE DSKOI,7,)1,0 
DEVICE FCDO0,8,12,0 
DEVICE RCDOO,9,!12,0 
COMM 13 
DEVICE TTYOI,14,14,0 
DEVICE TTY02,15,15,0 
DEVICE TTIY03,!16,16,0 
22 DEVICE TTY04,17,17,0 
TTY 14,14,9,0,300 
TTY 15,15,0,90,300 
TTY 16,14,0,9,300 
TTY 17,17,0,0,300 » 
3 { VARIABLE Z=TTY *500 
MEMPOOL ,LO,Z 
4 { MEMPOOL S.,¥* 
QUIT 


Example 3 Comments: 


1. 


Variable T and [ have been defined in VARIABLE directives 
replacing constant values in the SYS directive. T equals the 
total number of TTY and VIP terminals configured. I equals !0 
plus the number of KSR terminals configured. In the SYS 
directive, T replaces some constant value in the intermediate 
request block field. In this context, T specifies one 
additional trap save area for each TTY or VIP configured: I 
specifies that the number of additional intermediate request 
blocks equal {0 more than the number of KSR terminals 
configured. 


» 2. A maximum of four TTY terminals may be configured depending 


on the number of available channels (with asynchronous line 
adapters). All terminals have floating channel assignments 
and are confiqured in the order in which they appear in the 
CLM file. 


« 3. The variable Z is defined such that 500 words of memory are 


4. 


allocated for each configured TTY terminal). (Z equals 500 
times the number of configured TTY terminals). In the MEMPOOL 
directive that follows, Z specifies that 9001 LO allocates 500 
words of memory for each TTY configured. The size of pool LO 
could be 500, 1000, 1500, or 2000 words, denending on the 
final number of TTY teminals actually configured. 


This MEMPOOL directive allocates all unreserved memory to the 
system memory pool. 
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SECTION VI 
CLM DIRECTIVES FOR A COMMUNICATIONS CONFIGURATION 


This section describes the CLM directives used to define the 
communtcations environment of the system software. Cammunications 
CLM dtrectives may be entered from the CLM_USER file or from any 
file or device specified in a CLMIN directive. There after, a system 
startup can he performed. 


tf your Lastallation includes communications (MLCP/DLCP~connected) 
devicas, you should have the Communications Processing manual 
avallable for reference, 


The communications-related CLM directives cause the following 
functions to be performed: 


. Data structures (1.¢e., tables) are established corresponding to 
the comnunications hardware available to your system, 


- The following bound units are loaded into the central 
processor’s main memory! 


- Communications supervisor and mnultiline/dual line 
communications processor (MLCP/DLCP) driver. 


- (me or more Line protocol handlers (i.@., TITY, VIP, ACTD, 
ATO, STO, BSC, PVE, HASP, RCI, or user-written). 


+ The following elements are loaded into the RAM (random access 
nemory) of one or more Communications controllers? 


- Data set channel control orogram. 


- Channel control programs of one or more line protocol 
handlers. 


Table 4-1 summarizes the communications-related CLM directives, 
which are deseribed in alphabetic order in this section. Table 6~2 


orovides detailed {nformation on physical devices sunoported by 
various directives. 
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Table 6-1. Summary of Communications—Related CLM Directives 
Meaning 


ay SS FES AE TE SE IR ES a ETE IT TE AIO ES ICT IR ES IE 
Identifies a station on a line serviced by the 
Asynchronous Character Terminal Driver. 


Defines an Auto Call Unit and associates the ACU channel 
with a data communications channel. Optionally, provides 
one or more telephone numbers to be used in establishing 
a connection for the associated data communications 


channel. : : 

4) Identifies | a station on a Line serviced By the 
asynchronous terminal device (ATD) line protocol 
handler. 

BSC Identifies a station on a line serviced by the 8SC 
(binary synchronous communications) line protocol 
handler. 

COMM Establishes the priority level(s) at which the MLCP/DLCP 
interrupts the central processor. 

DEVICE Indicates ies the designated Soihmintoationé gia tica ts to 
to be accessible through the file system interface. 

fQLRN Defines multiple logical resource numbers (lrn’s) for 
the same ohysical communications device. 


HASP Identifies a remote workstation serviced by the HASP 
protocol. 

43270 Identifies a station on a line serviced by the BSC 3270 
protocol. 


LPH” Identifies the first (or only) station | on a line 
serviced by a user=written line protocol handler. 


LPHDEF Indicates nonstandard table sizes for channels and — 
stations controlled by a user=written line protocol 
handler. 

YODEM Defines 4 nonstandard modem type. . 


POLIST Identifies the start of the pool list ona line serviced 
by the synchronous terminal device line protocol 
handler. The line is identified by a STDLN directive. 


Identifies a polled VIP emulator “station® on a line 
serviced by the VIP line protocol handler. 
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Tabie 6~! (Cont). Summary of Communications=-Related CLM Directives 


Pigde nt ias's Pease Gace Geralial Uanoiced Ep eacc En a remote batch terminal serviced by the RCI 
protocol. 


Indicates that a receive-only srinter is connected to a 
station on a line serviced by the synchronous terminal 
device line protocol handler. The line is identified by 
an STDLN directive and the station ts identified by an 
STD directive. 


STAPOL Defines a saquence Of station poll addresses to be added 
to the poll list of a line serviced by the synchronous 
terminal device (STD) line protocol handler. The line is 


identified by an STDLN directive. 


Identifies a station on a line serviced by the 
synchronous terninal device (STD) line protocol handler. 
The line {ts identified by an STDLN directive. 


STOLN 4 Identifies a line serviced by the synchronous terminal 
device (STD line protocol handler. 

STATION Identifies the second or subsequent station on a line 
serviced by a userewritten Line protocol handler, 


Specifies the flle characteristics of a device that its 
not a disk device or a unit-record device. 


{dentifies a station on a line serviced by the TTY 


(teleprinter) Line protocol orinter. 


VDAM Incorporates the Display Formatting and Control software 
component in the configuration. 


vIp4 Identifies a polled or nonpolled synchronous visual 
{nformation projection (VIP) terminal on a line serviced 
by the VIP line protocol handler. Optionally, tdentifies 
an ROP (receive-only printer) station on the same line. 


VROSY 2 Identifies a PRUI001/1003/1005 device on a line serviced 


by the ATD line protocol handler. 
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Table 6=—!1 (Cont). Summary of Communications~Related CLM directives 


Directive Meaning = te eed oo ge, Boe ya —{ 


VTTY ¢ Identifies a teletype~like device on a line serviced by 
the ATID Line protocol handler. 


Identifies a VIP7200 or ViP7205 device on a line 


¥7200%° 
serviced by the ATD line protocol handler. 


: a 
. Tne ATD directive is intended as a replacement for the VROSY, VTTY, 
and V72390 directives. The protocol handler called by the ATID 
directive offers additiona! support capabilities e.g., block mode 
support of VIP7801/G2 devices, support of the VIP7207 device) not 
offered by the line protocol handler called by the VROSY, VITY, and 
Mika Soeseuress The VROSY, VITY, and V7200 directives can still 
e used, 


: 
Tne ATD directive or the V7200 directive must be specified if 
VIP7290 or VIP73801/02 terminals are to be used for forms processing 
using CII HONEYWELL BULL Olisplay Formatting and Control Factlity. 


¢ 
Tne TTY directive and the ATD directive sunport asynchronous 
terminal devices. The line protocol handler called by the TTY 
directive supports the physical terminal only tn teleprinter mode. 
Tne TTY line protocol handler does not provide block mode suoport 
of VIP7801/02 devicess neither does I€ provide support for VIP7200 
devices anid VIP7801/02 devices in forms processing mode. (For these 
functions the ATD directive is required). ATD line protocol 
handler does not provide the transparent I/0 or single character 
mode functions of the TTY Line protocol handler. 


3 
Tne STD directive and the VIP directive support synchronous 
terminal devices. Tne line protocol handler called by the STD 
directive offers additional support capabilities (e.g., line 
protocol handler called by the VIP directive. 


wwe. re 


Table 6-2. CLM Directives and Suppor ted Communications Devices 


Directive Devices Supported 
a a a gS ET 
ACTD VIP 7200 
OKU 7001 * 
OKU7002 + auxiliary badge 
+ auxiltfary printer 


VIP 7200 
VIP 7205 
VIP 780i 
VIP 7802 PRU t001t/1003/71005 
TAU 1001 /t003/1005 


Receive-only printers: 


PRU 1001/1003/1005 


VIP 7700 VIP 7700R 
VIP 7705R VIP 7760 
VIP 7804 VIP 7805 


Receive-only printers: 


™N 300 
TN 1200 
PRU 1003/1005 


VIP 7200 
VIP 7105 VIP 7205 
VIP 7801 VIP 7802 — 
TATU 1001710037 1.005 


Vir 7700 ViP 7700R 
VIP 77058 VIP 7760 
VIP 7805 VIP 7804 


Receive-only printers? 


T™N 300 ASR~33 
TIN 1200 ASR~35 
PRU 1003/1005 


PRU 1001710037 1005 
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Table 6=2 (Cont). CLM Directives and supported Cammuni cations 
Devices ’ 


ie eee reve. per ices see ee ea 
v7200~—d "yIP 7200 vip 7a01 7260 VIP 7801 

VIP 7205 - Vie 7802 

ASR= 33 KSR~ 33 

ASR=35 


You should observe the following rules for arranging 
camnmunications=-related CLM directives: 


1. The COMM directive must precede all other 
communications—jrelated CLM directives. 


2. If an LPHDEF directive is used in assoctation with a 
user-written line protocol handler, the LPHDEF directive must 
precede all related LPHn directives. — 


3. If STATION directives are used in association with an LPHn 
directive (in cases wiere a user-written line protocol handler 
drives more than one station per line), the STATION directives 
must immediately follow the related LPHn directive. . 


4. The DEVICE directive should follow related LPHDEF, STATION, 
and LPHn directives and related POLIST, STAPOL, ROP, STDLN, 
and STD directives. 


5. If an ACU directive is used, the station whose Irn apoears as 
an argument {nm the ACU directive must be defined in the 
directive that immediately precedes this ACU directive. 


5. NRen polled VIP“s are connected to a communications line, the 
Vie directives for the stations on the line must be 
consecutive. 


7. Nhen polled VIP emulator (PVE) stations sre associated witha — 
communications line, the PVE directives for all the stations 
on the line must be consecutive. 


8. The value assigned to the communications interrupt level (by 
the COMM directive) is normally restricted to the range 7 
through 57. At initial startup, the bootstrap device. is 
assigned level 6 by the system. If the level assigned to the 
bootstrap device is changed to a lower level (higher number) 
by a DEVICE directive, the communications interrupt level can 
be specified as 6. Tne level that is assigned to a 
communications device associated with a COMM directive is 
normally 8 through 58. 


9. Nhen an MLCP/DLCP operator console is configured, it must be 
assigned LRN O. 


10. 


Configuring a line serviced by the STD line protocol handler 
requires at least the directives STOLN, STD, POLIST, and 
STAPOL. An STD line may also use a ROP directive. The 
following diagram illustrates sequence rules for STD 
directives. Brackets enclose optional directives. One set of 
these directives must be specified for each line: 


STDLN must specify one for each line : 
To! 
CRP] specify one for each soecify One set for each 
station, if needed station on the lines all 
must precede POLIST 
STD ? 
CROP} 


POLIST must specify one for each line 


STAPOL must soecify one or more for 
each lines all STAPOL 
directives should be specified 
in the order in which stations 
are to be polled ~ 


{DEVICE}? <Coptional) specifies that the device will be 
accessible to the file system 


As a general rule, two line Reatarat handlers are allowed per 
MLCP/OLCP, 


The STTY command keyword format, as described immediately 
following the STTY directive, may be used as an alternative to 
the STTY dtrective format in your CLM ftle. The STTY command 
format provides additional features not sunported by the STTY 
directive format. For example, {f you wish to specify a 
terminal as being automatically reconnectable following a 
power failure or line drop, you must configure the terminal 
using the STTY command format in your CLM file. (For a 
complete descriotion of this capabllity, see Appendix D>. 


Each directive for a communications device must reference a 
unique logical resource number (lrn). If you wish to specify 
multiple communtcations directives which reference the same 
physical device, you should use the EQLAN directive. The EQLRN 
directive its described later in this section. 


. 
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TOPICS RELATED TO COMMUNICATIONS DIRECTIVES 


e 


" The following paragraphs describe: 


row to assign channel numbers to your communications devices, 
or, how to let the system dynamically assign channel numbers 


How to modify a terminal’s line length 


How to let the system dynamically assign a terminai’s line 
speed 


The emount of resident code required for communications 
modules. . 


You should review each of these topics before you create your CLM 


direc 


Assigning Channel Numbers 


tive file. 


Channel control programs are loaded into the MLCP on the basis of 
channel numbers you specify for communications devices. You should 
observe the following quidelines when assigning channel numbers to 


your 


&. As @ general rule. no More than two line protocol handlers can 


b. 


communications devices? 


be associated with a given MLCP. 


The MLCP with which a particular line protocol handler is 
associated is determined by the channel number(s) you enter 
for communications devices. The system checks the first six 
bits of the hexadecimal channel number you specify to 
determine LPH allocation. 


FCOO = FFSO first MLCP 

F800 ~ FB8O second MLCP 
This range of F400 = F780 causes the third MLCP 
channel numbers FOQOO = F380 )LPH to geo fourth MLCP 
specified for a ECOO = EFS&O into fifth MLCP 
device ° ° 


Each channel number must be a 4=-digit hexadecimal number 
ending in 00 or 80. Note that channel numbers lower then 0400 
are unavailable for communications devices. 
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DYNAMICALLY ASSIGNED CHANNEL NUMBERS 


For MLCP/DLCP-connected devices, channel numbers may be dynamically 
assigned or “floated” in TTY, VIP, VROSY, VTITY, ATD, V7200, or 
DEVICE directives. 


Assigning zero channel numbers to directives in the CLM file 
relieves the system dSuilder of the need to know the channel 
assignments for each installation that will receive a copy of file 
systen software. 


For each cammunications device configured, you have the option of 
specifying a channel number tn the appropriate directive or allowing 
the system to dynamically assign or “float* channel assignments at 
startup time. To float a channel, you specify the channel number 
parameter in the appropriate directive with a single zero (0). The 
system then assigns directives with floating channels to the first 
Available devices on the bus. Note that if you specify a floating 
channel and the system cannot locate an appropriate device, no ¢rror 
message is issued+ the system ignores this directive. 


[f your system includes device adapters but not assoc tated devices, 
it {s recommended that explicit channel numbers be assigned to all 
devices within the device class. 


Channel numbers are assigned as soon as the first floating channel 
1s encountered in the CLM file. To prevent devices with floating 
channels from inadvertently preempting devices whose channel numbers 
are explicitly specified, all directives of a given type with 
explicitly specified channel numbers should nrecede all directives 
of that tyoe with floating channels in the CLM file. All active 
channels should have higher bus addresses than all active channels 
to prevent the system fom tnadvertently assigning a device to an 
inactive channel. 


For MLCP/DLCP=connected devices, the first available channel with 
the highest bus address and appropriate channel adapter 
(asynchronous or synchronous) will be assigned to the first 
floatable channel in a communications directive, and 30 on. 


NOTE? Assigning floatable channels to communications devices is 
recommended only if all devices will be configured identically 
(if, for sxample, a system specifies that all asynchronous 
devices will he directly-connected VIP 7200’%s with tdentical 
line speeds, DEL characters, stop bits, and parity). The 
system cannot distinguish between different types of 
YLCP/DLCP=-connected devices.(1) 


C1) 

The “44—SYSDEF program does not permit you to configure MLCP/OLCP 
connected devices with floating channel numbers. M4_SYSDEF requires 
the system builder to suoply all channel numbers for communications 
devices. 
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If a system is configured with devices containing floatable channel 
numbers, the system, builder may determine all channel numbers 
assigned by the system as soon as possible after a system 
initialization. The system operator can issue tne command STS ~ALL 
to list each device and its channel number assignment, 


See Section V for an example illustrating the use of floating. 
channel number assignments. 


Modifying Terminal Line Length 


The line length specified for a terminal or other input device at 
system building time overrides the command processor line length of 
127 characters. For example, at terminal configured with a line 
length of 80 characters, you cannot enter a continuous command line 
longer than 80 characters unless you type an ampersand (&) at the 
end of tne line and then continue on one or more additional lines. 
You can alter the terminal’s line length by using the set terminal 
characteristics CSTTY) command (described elsewhere in this manual) 
after system initialization or by modifying the STTY directive in 
your CLM file. 


Terminal Line Speed Selection Capability (Asynchronous Terminals 
EEE ———e—eE———————_——E— : mare 


When you specify an ATD, TTY, LPHn, VTTY, or V7200 directive, you 
have the option of deferring selection of an asynchronous terminal’s 
line speed (specified by the fifth parameter) until the terminal 
comes online (1). To defer selection of a terminal’s line speed, you 
specify the fifth parameter as either “HI* or "LOW in one of the 
above-mentioned directives. Choosing this option frees you from 
specifying an exact line speed for every asynchronous terminal in 
your configuration. The interactive system building program, 
M4_SYSDEF, incorporates this deferred sneed selection capability. 


In order to allow the system to determine the terminal’s line speed, 
the Operator presses the RETURN key on the terminal’s keyboard when 
the terminal comes online. If, after several seconds, normal 
terminal Operations have not begun, the Operator should check for 
One of the following problems: 


(1) 
If you choose this option, an Auto Call Unit must not 2S cont igure? 
for the terminal. 
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2. 


3. 


The terminal’s line speed may not be within the range 
specified in the appropriate CLM directive. The operator may 
be able to adjust the terminal’s line speed to fall within the 
range specified by the directive. The operator should then 
press the RETURN key. If, however, the terminal’s line speed 
is fixed, adjustments must be made to the appropriate CLM 
directive. You may be required to change the designation of 
the terminal’s line speed itn the appropriate CLM directive. 


If the carriage return character was garbled and the system 
could not determine the line speed of the termtnal, the 
operator should press the RETURN key again. oe 


If the terminal’s modem has gone offline, the operator must 
dial up the line again. 


If the system fails to receive a character transmission within 40 
seconis, the terminal will be disconnected. ; 


Resident Code Requtrements for Communications Modules 


. The following table defines the number of words of resident code 
required for various communtcations moduless the table also list the 
nemory required in the MLCP/DLCP for associated channel control 
programs (CCP’%s), Memory requirements for noncommunicattions nodules 
are defined in Section V. 


6=t1 


Table 6-3. Communications Memory Requirements 


Resident MLCP Memory DLCP Memory 

Memory Required for Required for 

(LAF) CCP C1) Cccp €2) 
Component {tin words) (in words) (in bytes) Cin bytes) 


Cone Supervisor| 2a | 2.5K | WA [WA 


ee 


}Speed select | select 


‘| TTY Line 1429 1772 
Protocol Hand ler 
VIP Line 1346 1760 
Protocol Handler 
BSC Line $1100 EBCDIC 1574 EBCDIC 
Protocol Handler 870 ASCIT 1126 ASCII 
PVE Line 1182 
Protocol Hard ler 


RCI Line 

Protocol handler 

ATD Line 

protocol Hand ler 

ACTD Line 

Protocol Handler 

Al aay 0. ISK 
SURSYSCORS 
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NOTE? Sizes do not include patch space sizes. Patch space is only 
required as patches are added, 


(1) 
2942 bytes of RAM memory are available in the MLCP for the loading 
of channel control progrags. Any combination of the various CCP’s 
can be loaded into the MLCP provided the total memory does not 
excead 2942 bytes. 


(2) 
3844 bytes of RAM memory are available in the DLCP for the loading 
of channel orograms. Any combination of the various CCP“s can be 
loaded tnto the DLCP provided the total memory does not exceed 3844 

bytes. 
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ACTD 
ACID OIRECTIVE 


Directive Name: ACTD 

The ACTD directive identifies a station on a line serviced by the 

asynchronous character terminal device line srotocol handler. This 

directive is used when configuring stations of the following types? — 
DKU 7062, DKU 7001, VIP F200, VIP 7100 or TTY device. 


See Appendix. R to configure a station serviced by ACTD line protocol 
handler. 
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ACU 


ACU OL[RECTIVE 


Directive Namet ACU 


The ACU directive tdentifies an Auto Call Unit and associates the 
ACU channel with a data communications channel. The ACU directive 
must immediately follow the directive describing the station whose 
Irn is specified in the ACU directive. The ACU directive cannot be 
assoOctated with any data communications channel that supports the 
speed select option. 


The ACU directive oermits the actdition of telephone numbers to a 
list of numbers maintained for a data communications channel. The 
list of telephone numbers for a data communications channel can be 
unlimited and has the following format: 


Santry 0 empty ({nitially) 
{Entry | phone_number 1] 
CEntry 2 ohone_number 2] 
Cetc.] 


The Auto Call Unit dials each number in the List three times at 
40-second intervals until the list is exhausted or a connection is 
made, 


The first ACU directive that relates an Auto Call Unit to this data 
communications channel causes an empty entry 0 to be establisheds 
this entry in the list nay be loaded and reloaded, as desired, by 
means of an SDL (set ACU telephone number) command or sSOL macro 
call. The first ACU directive also creates an entry in the table 
(starting with entry 1) for each telephone number (if any) specified 
in the dilreetive. Any subsequent ACU directive relating the same ACU 
to the same data communications channel causes one or more 
additional antries ta he added to the Lists the additional entries 
are aided to the end of the List in the order in which the teleohone 
numbers appear in the ACU directive, 


Formatt 


ACU Irn, level ,X’%acu_channel ’[“phone_#17{,’ phone_#27(,...]}) 


6715 


=> Argument Desctiptions 
Oo 
<q irn 


The logical resource number of any station on the date 
communications channel with which this Auto Call Unit is associated. 


level 


The priority level of the station whose Irn appears in the Irn 
argument of this directive. 


X“acu_channel’ 


A 4_digit hexadecimal number (from X7400% to X’FFS80~) specifying the 
channel number of the Auto Call Unit. 


Bits 0 through 9 = The !l6-bit channel address of the send 
or receive channel on the line. 


Bits 10 through 15 = Must be set to zero. 
C“phone_#n? ) 


A string of 1} to 14 ASCII characters chosen from the set 0 !2345 
4 789 = (separator) * #, 


FUNCTIONAL DESCRIPTION® 


nm ACU directive causes the Auto Call Unit to initiate a line 
connection with a remotes auto answer data set. When the software 
issues a connect order and bit 2 of the IORB is set to one, the Auto 
Call Unit attempts to dial a line using the list of telephone 
numbers established at configuration time. The Auto Cali Unit dials 
each number in the list three times at 40=—second intervals until a 
connection is made or the list is exhausted. 


Examples 
TITY 26,8,X7FCO0O?" 
ACU 25,8, X7FDO00%, 7 1-555-240-0291 


In this example, an Auto Call Unit om channel FDOO is assoctated 
with the data communications channel (FCOO) servicing a TIY whose 
logical resource number is 26 and whose priority level is 8. Since 
this is the first ACU directive for this Auto Call Unit, the 
telephone number in the ACU directive is established as entry | in 
the list of telephone numbers for the indicated data communicaticns 
channel (FCO00). Note that tre ACU directive immediately follows the 
TTY directive that describes the station whose Irn appears in the 
ACU directive. 
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ATD 
ATD DIRECTIVE 


Directive Name: ATD 


’ The ATO directive tdentifies a station on @ line serviced by the 


asynchronous terminal device line protocol handler. This directive 
is used to configure asynchronous terminals as part of the 
comnunications system. The ATD directives must follows the COMM 
directive in the CLM file. You. can float the channel number 
assignments in this directive, if you wish. 


Format: 


ATD Irn,level,X’channel’, (modem), (speed),{*device-type } 


[del] ,Cstop-biti( ,parity] 


Argument Deseription: 
irn 


The logical resource number associated with the station. The value 
for Irn is an integer from 3 through 255. A program may use this 
number to identify the station when it requests an input/output 
operation to the station. . 


level 
The priority level at which the ATS Line protocol handler processes 
requests for an input/output operation to the station. The value for 


level is an integer from 7 through 61% it may be the same as the 
level specified for other communications stations, but tt must be a 


higher number than the communications interrupt level(s) speci fied 
in the COMM directive. 

X’%channel’ 

You may specify a single zero (0) to float this channel assignment 
or a four-digit hexadecimal number (from X“040n% to X“FF8n’), that 
specifies the channel number of the station and the {nterrupt 
oriorlty level (n) of the Line. The channel number has the 
following formats 


“Bits 9 through 9 = The 1l0-bit channel address of the send or 
receive channel on the Line. 


Bits 10 through 13 = Must be set to zero, 


Bits 14 and 15 ~ Specifies n, the oprtority level at which a 
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AID 


communications line interrupts the central 
processor. n may have a value of 0,i,2. or 3 as 
specified in the COMM directive, See the 
deseription of the COMM directive for further 
information. 


(modem ] 


A number specifying the type of data set. Possible values are as 
follows: 


QO - Direct Connect. 


} = Bell Ixx=type modem (103A, etc.). Both data-set-ready and 
carrier-detect signals are required for 4 connection: absence of 
these signals is a disconnection. 


3 or greater ~ User-defined modem type (see “MODEM Directive,* 
earlier in this section). 


The default value is modem type |. 
{ speed] 
The data rate in bits per second. 


For aa asynchronous line with a communications<-pac whose id is 
2108(16), use one of the following values for speed? 


50 300 2400 

: 75 600 3600 
(Default) 110 900 #4800 
134 1200 7200 

150 1800 9600 


For an asynchronous line with a communications=<pac whose id (in 
hexadecimal notation) is 2100, 2110, or 2118, or 3118, use one of 
the following values for speed: 


50 200 1800 . 
75 300 2000 Z 
(Default) 110 600 2400 


134 1050 4800 
150 1200 - 9600 


The deferred speed selection, option functions with the second 
set or adapter types only. 


NOTE: If the data rate is 134.5, specify 134. 
You have the option to defer selection of the line speed until the 


terminal comes online. You select this option by specifying HI or 
LO. 
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*HIY 


Soecifies that all terminals associated with this line will be 
permitted to function only at speeds from 1200 through 9600 
bits per second. 


“LY * 
Specifies that all terminals associated with this line will be 
permitted to function only at speeds from 110 through 1200 bits 
per second. 
For more information about the line speed selection capability, 
refer to the discussion under “Topics Related to CLM Directives* 
near the beginning of this section. 
( “device=type® ] 


Specifies the type of terminal used. [f this argument ts not 
specified, the default is TTY. Possible values are? 


Value Physical devices suoported 
72090 VIP 7200, VIP 7205 


7801 VIP 780I, VIP 7802 
D7200 VIP 7207 


PRU PRU 1001, PRU 1003, PRU !005, 
: TWU $001, TWU 1003, THU 1005 


TTY An asynehronous terminal 
that is to be supported as 
teleprinter-compatible 


T™TN300 Terninet 300, PRU [004 
(dell 


In TTY mode, a head-of-form sequence (pre-order control) consisting 
of three LF’%s and the number of DEL characters specified by this 
argumant is jzenerated if the following conditions are met. (If the 
conditions are not met, no head-of-form sequence is generated). 


« The first byte of the anplication’s buffer must be designated 
as a control bytes fi.e., bit 4 of the IORB%s device specific 
word (I1.DVS) must be set to 0 to write time, 


« The control byte must spectfy that a head-of-form sequence is 
to be generated: {.4., Sit 3 of the control byte must be set 
to i. 


« Device type PRU is not specified. If it ts specified, a true 
head~of-form is issued. 
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©) In the field or TTY modes, an LF in an end-of-message sequence (post 
order control) is followed by the number of DEL cheracters specified 
“€ by this control argument, uy 


The EOM sequence is controlled by the Be and C=bits of the IORB/s 
device=specific word I_DVS, as. specified by the application at write 
time. The TTY line protocol handler sends an EQM sequence according 
to the following B= and Cebit values: 


I_DVS Bits 

B C EQM Sequence 

0 ‘a CR 

0 } None 

! 0 CR,LF,DEL characters 
] 1 


LF,DEL characters 


At read time, the application can specify the same Be and C= bit 
values in order to send an EOM sequence back to the terminal when 
the message is successfully received. 


7 
Note that an LF character in a pre-order control specified by the 
I_CON word of IORB is never followed by a DEL character, i.e., this 
control argument has no effect in this case. 
This argument allows you to select 1 to 32 DEL characters. The 
default for each type of device is as follows: 
Dev ice~Type Number of DEL Characters 
7200 0 
7800 re) 
PRUIO01/1003/ 1005 t 
att I 
PRU i904 32 
[stop=-bit] 
Specifies the number of step bits that are to follow each character. 
A value of ! or 2 can be chosen for each device. Default values are 
as follows? 
Number of Stop Bits 
i 
(For speeds greater 
than 110 bits per second) 
2 
(For a ssead of 110 bits 
per second or less) 
Cparity!} 
Specifies the type of parity (*0DD" or "EVEN") to be used. The 
default is EVEN, 
a4 
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Examples 


ATD 15,17,X“F800" ,0,150,7 7200 = 
In this example a VIP 7200 terminal is connected to a line serviced a 
by the ATD line protocol handler. The device defaults for del, 
stop-bit, and parity are assumed. 
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BSC 
BSC_DIRECTIVE 


Directive Namet BSC 


The BSC directive identifies @ station serviced by the binary 
synchronous communications line protocol handler.(1) 


Formats 


BSC Irn, level ,X’channel’ ,[modem)],{primary/secondary), 
(character.setl{,multi block count) 


Argument Descriptions 


irn 


The logical resource number associated with the station. The value 
for irn its an integer from 3 through 252. A program may use this 
number to itdentify the station when it requests an input/output 
operation toe the station. 


level 


This priority level at which the comnunications supervisor processes 
requests for an inout/output operation to the station. The value for 
level is an integer from 7 through 621 it may be the same as the 
level specified for other communications stations, but it must be a 
higher number than the communications interrupt level(s) specified 
in the COMM directive. The level specified for one or more 
communications stations may not also he used for noncommunications 
devices or tasks. , 


C1) 

In the station is to be accessible through the file system 
interface, an appropriate DEVICE directive must be “paired” with te 
BSC directive (See "DEVICE Directive," later in this section). If 
input/output to the station is to be asynchronous, the 8B (huffered) 
argument must be included in the DEVICE directive. 
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X“channel’ 

A four-digit hexadectmal number (from X7040n to X’FF8nN’), specifying 
the channel number of the station and the interrupt priority level 
{n) of the line. The channel number has the following format: 


Bits O through 9 - The 10-bit channel acdress of the send or 
receive channel on the line. 


Bits {0 through 13 — Must be set to zero. 

Bits 14 and 15 ~ Specified n, the priority level at which a 
communications Line interrupts the central 
processor. nm may have a value of 0,!1,2, or 3 as 
specifled in the COMM directive. See the 
deseription of the CQ’MM directive for further 
information. 

(modem) 


A number spectfying the type of data set. Possible values are as 
follows? 


QO =~ Direct connect. 

2- Bell 2xx-type modem (201A, 208B, atc). The data-set-ready signal 
is needed for a connectlont absence of this signal is a 
disconnected. 


3 a greater —- User-defined modem type (see “MODEM directive,” later 
in this section). 


The default value is modem type 2. 

(primary/ secondary] ee eee -- 
Values may be specified as P or St indicates whether this is a 
primary or secondary endpoint of the transmission. A primary 
endpoint (the default) has priority in contention mode. 
{character-set] 

Qne of the following may be specified: 

AS ASCII (the default). 

EB EBcDIc. 


The user 1s responsible for using the correct character set. The BSC 
protocol does not serform character translation. 
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> (multicplock count] 


An integer from ! to 7 specifies the maexiaum number of data blocks 
for a single transmission in multivblock mode. The default is that 
multi@block mode is not used. 


Example? 

BSC 29,4,X*%FDO00’,2,5,&8B 

DEVICE BSCO0,29,.6,X7FDO0" ,HOST,.B 
In this examole, line FDOO is used for communications with enother 
computer. Modem type 2 is used for the line. The Level 6 computer 
is the secondary endpoint on the line. A file system interface is 


established for the station by the DEVICE directive. Muitiblock mode 
is not used. 
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COMM 
COMM DIRECTIVE 


OLrective Names CMM 


The CuMM directive is mandatory in a system that includes 
communications. It specifies from one to four priority levels at 
which communications lines can interrupt the central processor. The 


COMM directive must precede all other comnunications=-related CLM 
directives, 


Formats 


COMM lavel_O C ,€level_ii(€,Clevel_2)(,C levei_3)32) 


Argument Descrioptions 


Level _O 

Clevel_i} 
(level_2) 
{[level_3] 


The four possible oriority levels at which a communications line 
interrupts the central processor. At least one oriority level must 
be specified. . Values for lLevel_O through level_3 must be in the 
ranja of 7 through 61 and must not duolicate any other 
non=-communications device priority levels. Each value chosen for 
level_o through level_3 must be greater or equal (have a lower or 
2qual orfiority) to the preceding level. The default values for 
level_i through lLevel_3 are equal to the value assigned to the next 
highest priority level (level_(n-1)). For example, tf a oriority 
value has not been assigned for Level_2 in a COMM directive, the 
ariority value specified for level_l {ts assumed. (See the third TTY 
Sirective in the example that follows). 


Functional Desertptton: 


The COMM directive specifies from one to four oriority levels at 
which communications lines can interrupt the central processor, as 
sjescrihed above, 


The interrupt level for a communications line its specified by the 
values of bits !4 and 15 of the channel number argument in the 
directive that identifies the line. Bits !4 and !5 correspond to the 
positions of the level_n arguments specified tn the COMM directive. 
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COMM 


Example 


COMM 10,11 

TITY 20,20,X°FFOO% , occ 
BSC 23,21 X7FCOIN/ pce 
BSC 22,22, X7FC81% , ose 


level_O 
level! 
level_l 


priority 
(interruot) 
level 


Se cep te 


10 
VI 
i} 


In this example, three line pretocol handlers are configured. The 
TTY associated with Irn 20 processes interrupts on level 10% the 8SC 
station with lrn 21 processes interrupts on level 1!, as does the 


BSC station with lrn 22.. 
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DEVICE 


DEVICE DIRECTIVE ; =. 


Directive Names DEVICE 


The DEVICE directive is required for a communications station only 
if it is to be accessible through the file system interface. In this 
case, the DEVICE directive must be “paired® with the saporooriate 
station-defining directive (f{.e., TTY, ATO, STD, VIP, BSC, PVE, 
HASP, or RCI) so that each oair contains the same Irn, level, and 
channel number. You may float channel numbers, if you wish. The 
DEVICE directive should follow related LPHDEF, STATION, and LPHn 
directives and related POLIST, STAPOL, ROP, STOLN, and STD 
directives. 


You must include a spectal format of the DEVICE directive itn your 
CLM file if your tnstallation will use a dual-ourpose operator 
terminal. Refer to "Configuring a Dual-rurpose Operator Terminal” 
in Section V. 


Formatt 


QJEVICE device_unit,Iirn,level ,X’channel’,{(device_namel, 


B 
(record_size) .} N | 


Argument Descriptions 
device_unit 


A string Of up to six ASCII characterss the first three or four 
characters identify the tyoe of station and the last character 
(alphanumeric) identifies one specific station of that type. The 
pernissible values of device unit are as followse 


TTYnn 
BSCnn 
XBSCnn 
VIPnn 
PVEnn 
ROP nn 
ATDnn 
STOnn 
HASP an 
RC Inn 


The default characteristics of various tyoes of stations are jlven 


below. Some of the default characteristics are specified by the 
default value of the device specific words (dsw). Cartain default 
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DEVICE 


characteristics for any station tn the configuration can be changed 
by use of the CLM directive STTY which is described later in this 
section. The description of the STTY directive includes an 
explanation of the device specific words. 


In addition, a user can override (temporarily change) certain 
default characteristics of a station he is using by the system 
command STTY or the macro cali sSTTY. 
TTY¥nn 
« Record sizes 73 bytes (including control byte) 
- Oevice specific word for connect/disconnect = 0 
- No autodial used 
- Hang up phone on disconnect 
~- Queue abort 


Device specific word for read/write 2 0030 (hexadecimal) 


Tratling carriage return 
Trailig line feed : 
Echo mode 

Leading control byte 


66 ad 


« Detab is on 
« Input is asynchronous 
- tutput is asynchronous 
« Type is bidirectional 
8SCnn 
« 30S 2780 protocol 
« Record size: 137 bytes (including control byte) 
e Device specific word for connect/disconnect 2 0 
No autodial used 
Hand up phone or disconnect 
Leading control byte 


Queue abort 
Buffer mode is single record 


hibag 


« Device specific word for read/write = 0000 (hexadecimal) 
= Leading control byte 
id - Detab ts OFF 


« Input is nonbuffered synchronous 
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Vutput fs nonbuffered synchronous 


Type is input only between connects Or sutput only between 
connects 


X8SCan 


e 


BSC’ 3780 protocol 
Record sizet 137 bytes ({ncluding control byte) 
Device specific word for connect/disconnect = QO 


~ Hang up phone on disconnect 
= Queue abort 


Device specific word for read/write = 0040 (hexadecimal) 
~ Leading control byte 

Detab is OFF 

Taput is asynchronous 

Qutput is asynchronous 


Type is bidirectional 


VIPnn 


e 


Record sizet 81 bytes (including control byte) 


Device specific word for connect/disconnect # 0100 
(hexadecimal) 


- Logical read time-out interval is !0 minutes 
- No autodial {is used 

~ Home cursor on page overflow 

~ Leading control byte 


~ Poll interval of one second (ignored ts nonpolled VIP) 
- Hang up phone on disconnect 
~- Queue abort 


Do not save function codes in read [ORB (Input/Output Request 


Block) 
Device specific word for read/write = 0010 (hexadecimal) 


- Trailing carriage return 
~ Trailing Line feed 

- Input/Output ts asynchronous 
~ Type is bidtrectional 


PVEnn 


° 


Record sizet 8! bytes (including control bytes) 
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DEVICE 


Device specific word for connect/diconnect = 0 


NO autodial is used 

Do not save function codes in read IORB. 
Hang up phone on disconnected 

Queue abont or disconnect 


poe 


Device specific word for read/write = 0 
Detab {ts ON 

Input is asynchronous 

Wutput Is asynchronous 


Type is bidirectional 


ROP AN 


sd 


Record size: 73 bytes (including control byte) 
Vevice specific word = 0000 (hexadecimal) 

- Tralling carriage return 

~ Leading control byte 

= Physical disconnect 

~ Queue abort 

Detab is ON 

Input is asynchronous 

Quptut is asynchronous 


Type is output 


ATOnn 


Record sizet 73 bytes 

Device specific word for connect/disconnect = 0 

- No autodial is used 

- Hang up phone on dissonnect 

- Queue abort 

Device specific word for read/write = 30 (hexadecimal) 


- Echo input character (echo mode) 
- Line feed at end of messazge (EM) 


Detab is ON 
Inout is asynchronous 


Jutput is asynchronous 
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NY 


Type is bidirectional 


‘$TOnn 


° 


Record size: Sli bytes 
Devica specific word for connect/disconnect = 103 (hexadecimal) 


No autodial is used 

Home cursor on page overflow 

Leading control byte 

Logical poll interval = ! second 

No soace suppress 

No roll 

Hardware function codes are specified in write requests 
NO timeout on read request 

Send DLE £0T (Data Link Escapes End of Transmission) (7804) 
on disconnect 

Hang up phone on disconnect 

Queue abdort . 


@atovatadba 


Device specific word for read/write = 10 (hexadecimal) 


- Carriage return at end Of message 
~ Line feed at end of message 
—- Print one copy (7804) 


HASPnn 


¢ 


Record sizet 520 bytes (including control bytes) ov 


Device specific word for connect and disconnect = 0090 
(hexadecimal) 


~ Queue abort 
~ Hang up phone on disconnect 


Yevice specific word for read/write = 0100 
~ Leading control hyte 

Detabd is ON 

Input is asynchronous 

Jutput is asynchronous 


Type is bidirectional 


RCInn 


e 


Record sizes 132 bytes (including control byte) 
Device specific word for connect and disconnect = 0003 


~ Do not hang up ohone on disconnect 
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DEVICE 


= No queue abort 
« Device specific word for read/write = 0100 


= Do not quit upon receiving break 
- Leading control byte 


« Detad is ON 

« Inout is synehronous 

« Jutput is synchronous 

« Type is bidirectional 
Irn 


Tne logical resource number of the station identified by the ATD, 
STO, TTY, VIP, BSC, PVE, HASP, or RCI directive with which this 
DEVICE directive is “paired”, (A ROP its identified in a VIP 
directive). The value of Irn is an integer from 3 through 255. 


level 


The priority level of the station identified by the ATD, STD, TTY, 
VIP, 8SC, PVE, HASP, or RCI directive with which this DEVICE 
directive is "“paired*. 


The value for level is an integer from 7 through 61% it may be the 
same as the level specified for other communications stations, but 
it must be a higher number than the communications interrupt 

Level(s) speci?ted In the COMM directive. The level specified for ~~ 
one Or more communications stations may not also be used for 
noncommunications devices or tasks. 


X“chaanel 


The channel number of the station identified by the ATD, STD, TTY, 
VIP, 8SC, PVE, HASP, or RCI directive with which this DEVICE 
directive is “paired”. Bits 10 through IS of the channel number 
specified in a DEVICE directive should equal O even though they may 
net equal O in the "paired" directive. Bits 15 and !6 of the channel 
number soecified in a DEVICE directive do not indicate the interrupt 
level of the communications line. You can float this channel 
assignment by specifyig a single zero (0), if you wish. 


{device_nane) 

A string of | to 12 ASCII characters, the first of which must be 
alphabetic. This device name is a unique name by which the station 
can be referred to within the file system. If a device_name is not 
specified, the device_unit argument is used as the device_name. 
{record size] 


The length, in bytes, of one physical record. If recordisize is not 
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specified, the default record .stze is as established by the 
device_unit argument. 


i 


For normally unbuffered stations (viz., BSC, HASP, RCI), B indicates 
that input/output to the station is to be buffered, 


For normally buffered stations (viz... TTY, VIP, PVE, ROP), N 
indicates that input/output to the station is to be unbuffered. 


Por TTY, VIP. ROP, PVE, ATO, and STD stations, the default is 
buffered. For HASP, RCI, BSC, and XBSC stations, the default is 
undu ffered. 


Input/output to a buffered station may be asynchronous or 
synchronous. I[nput/output to an unbuffered station is always 
synchronous’ tabulation characters are not expanded, 


For a BSC 3780 (XBSC) station, input/output must be asynchronous. 
Therefore, this argument must not be specified as N for an X55c 
station. 


For the following station tyoess 


tabulation characters are normally expanded into space characters. 
Tabulation characters are not expanded if N is specified for these 
station types. Tabulation characters are never expanded for 8SC or 
XBSC station types. 


Functional Descriptions 


If a communications station is to be accessible through the file 
system interface, the station’s TITY, VIP, ATM, STD, 3SC, PVE, HASP, 
or RCI directive must be "paired® with a DEVICE directive, The Irn, 
level, and channel numbers for each oair of directives must be 
identical. (Note that this requirement applies to an 
MLCP/DLCP-connected operator terminal). 


Multiple DEVICE directives that specify the same Irn and level are 


invalid. The EQLRN directive (descrihed elsewnere itn this section) 
allows you to equate multiple Irn’s for a device. 
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DEVICE 


Example 18 
TTY 21,8,X%FF80%, ,300 
DEVICE TTY00,21,8,X“FF8O" , TIYFILE 


In this example, 4 TTY is to be accessible through the file systen 
interface. The DEVICE directive contains the same Irn, level, and 
channel number as the ITY directive. The default characteristics of 
the station are shown under the device_unit argument above. The 
default record size (73 bytes) is also to be used since no 

record size argument is specified in the DEVICE directive. The 
device name TTYFILE is to be used for references to the station 
within the file system. 


Example 238 
SYS Soe eee eo 


STDLN 10,X“FFO0%,2,2400,W4 

‘STD 20,0,,V7805 

ROP ROSY26 

STD 2!,1,.,V7804 

“STD 22,2 

POLIST 2 

STAPOL 0,1,0,2 

DEVICE STDOO,20,!0,X“FFOO" ,V7805,80,B 
DEVICE STDO2,21,10,X”FF00% ,.V7804,80,B 
DEVICE STDO3,22,!0,X“FFO0’ ,V7804,80,8 


In this example, three synchronous devices are to be accessible 
through the file system interface. DEVICE STDOO, DEVICE STDO2, and 
DEVICE STDO3 directives are paired with the first, second, and thrid 


“STO directives in the CLM file. Note that each DEVICE directive has 


the same irn, level, and channel mumber as specified in {ts paired 
STD directive. DEVICE directives may appear anywhere in your CLH 
file. 
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EQLRN OIRECTIVE 


Directive Names EQLRN 


The EQLRN directive allows you to specify multiole logical resource 
numbers (lrn’%s) for the same physical device, Although each device 
in a communications configuration must be assigned a unique irn, the 
SQLAN directive permits you to “equate” two or more Irn’s to 
reference the same physical device. 


Format t 


EQLRN Irn ,lrn (,1irn ,..-) 
p $s s 


Argument Deseripttions 


Irn 
Cp) 


The orimary logical resource number assoc{fated with the physical 
device. This argument must de specified. 


irn 
(s) 


The secondary logical resource number(s) that will be assoctlated 
with the device heing referenced by Irn(p). You nust svecify one or 
more Irni{s) arguments. Values you svecify for Irn (s) must be 
numerically less than the Largest Irn used in a communications 
DEVICE directive or any other communications directive. 


The follwing example Lllustrates one possible application of the 
EQLRN directive? 


A communmications device can be driven with two different sets of 
device characteristics via the same user-written driver. Each 
different logical device is referenced by a tinique file name. This 
requires two separate communications DEVICE directives, each 
specifying a unique file name. The device characteristics are 
specified by STTY directives. 
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The following set of CLM directives illustrate those directives 
which must be included at configuration times 


= 
re 
aval 
Co 
Lu e 


CMM 9 

LPH3 32,32,X”’FF80%,,4800 

DEVICE TTY05,32,32,X“FF 80/7 ,CDROO, 80 
STTY CDROO, .X70CO0" , co 

DEVICE TTYO$, 33,32, X* FF 80", CRPOO, 80 
STTY CReOO,.X70800% , OFF 

EQLAN 32, 33 


4 


ATD 35,35,X“FOO” ,0,9500,77200° 
DEVICE TTYO7,35,35,X“FFO0",,,N 


Note that the last two directives above specify an Irn that is 
numerically larger than those specified in the EQLRN directive. The 
Irn’s specified in the EQLRN directive must be numerically less than 
the largest irn specified in any other communications directive. 
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HAS? DIRECTIVE 


Directive Names HASP 


The HASP directive identifies an IBM workstation ona line serviced 
by the HASP line protocol handler.(1) 


rormat ¢t 


HASP Lrn, level ,X’channel’, [modem] 


Argument Descriptions 
lrn 


The logical resource number associated with the station. The value 
for irn is an integer from 3 through 255. A program may use this 
number to identify the station when it requests an {nout/output 
operation to the station. 


level 


The priority level at which the communications supervisor processes 
requests for an input/output operation to the station. The value for 
level is an integer from 7 through 61% it may be the same as the 
level specified for other communications station, but it must be a 
higher number than the communications interrupt level(s) specified 
In the COMM directive. The level specified for one or more 
communications stations may not also be used for noncommunications 
devices or tasks. 


(1) 
If te station is to be accessible through the file system 
interface, an appropriate DEVICE directive must be “patred” with 
the ASP directive (See DEVICE Directive,” earlier in this 
section). [f input/output to the station is to be asynchronous, the 
B (buffered) argument must be included in the DEVICE directive. 
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HASP 


X¥*channel’ 


A four-digit hexadecimal number (from X7040n’ to X“FF8n“) specifying —~ 
the channel number of the station and the interrust priority level 
(n) of the line. The channel number has the following format: 


Bits O through 9 «= The i0ebit channel address of the send or 
receive channel on the line. 


Bits 10 through 13 = Must be set to zern. 

sits 14 and 15 = Soecifies a, the priority level at which a 
communications iine interruots the central 
processor. nm may have a value of 0,1,2, or 3 as 
specified in the COMM directive. See the 
deseription of the COMM directive for further 
information. 

(modem) 


A number specifying the type of data set. Possible values are as 
follows: 


O = Direct connect. 

2- dell 2xx-type modem (201A, 208B, etc.). The data~set-ready 
signal is needed for a connections absence of this signal is a 
disconnection. ‘ 


3 or greater ~ User-defined modem type (see "MODEM directive", later 
in this section). 


The default value is modem type 2. 
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H3270 DIRECTIVE 


Directive Namet 43270 


The H3270 directive identifies a station on a line serviced by the 
BSC 3270 line protocol handler. Only one station may be configured 
On @ line. 


Format: 


H3270) Irn,level,x’“channel?’, (modem) ,X“poll_address’, 
X“select_address/’ 


Argument Deseription: 
Iron 


The logical resource number associated with the station. The value 
of ira is an integer from 3 through 255. A program may use this 
number to identify the station when it requests an input/output 
operation to the station. 


level 


The priority level at which the communications supervisor processes 
requests for an inout/output operation to the station. The value for 


level ts an integer from 7 own 61% it may be the same as the 
level specified for other communications stations, but {t must he a 
higher number than the communications tnterrupt level(s) specified 
tn the COMM directive. The level specified for one or more 


communications stations may not also be used for noncommunications 
devices or tasks. 


X’7channel 


A 4-digit hexadecinal number (from X%040n% to X“FF8N’), specitying 


the cnannel number of the station and the interrupt priority level 
(nd of the line. The channel number has the following format? 


Bits O through ? ~- The !O-bit channel address of the send or 
receive channel on the line. 


Bits 10 through 13 = Must be set to zero. 


Bits 14 and 15 ~ Specifies n, the priority level at which a 
cammunications line interrupts the central 
oprocessor. n may have value of O, |, 2, or 3 as 
Specified in the CQOYWM directive. See the 
deseriotion of the COMM directive for further 
{nformation. 
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{ moden] 


Ss 
(I A number specifying the tyoe of data set. Pessible values are as 
followss 

QO = Jlrect connect. 

2=- Bell 2xx=type modem (201A, 208B, ete.). The data-set~ready 


signal is needed for a connection: absence of this signal is a 
disconnection. 


+ 


3 or greater <- User-defined modem type (see “MODEM Directive", later 
in this section}. 


Tne default value is modem type 2. 
X’*pollvaddress? 


A 2=dijit hexadecimal number (from xX°00% to X*“FFY) specifying the 
poll address of the 3270 control unit. 


X“select_address/’ 


A 2-dizit hexadecimal number (from X’00% to X’FFY) specifying the 
select address Of a 3270 device. 


Examples 
43270 25,20, X“FCO0% , 2, X% 60%, X740" 


In this example the host will use an address of X%640% to poll this 
station and an artdress of X740% to select this station. 
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LPHn 
LeHn DIRECTIVE 


Directive Name? LPHn 


The LPHn directive identifies the first (or only) station on a Line 
serviced by 3 user-written Line protocol nandler.(1) 


Formats 


LPHn Irn, level, X’channel’ [modem] ,.{ speed], 
(FDX/HDX 3€ ,Lphusoeci fic_word! 


In the directive mame LPHn, 1 {fs an integer from 0 through 3 and 
identifies a specific line srotocol handler. If an _PHDEF directive 
is used in associated with this line protocol handler, the value of 
the lpm argument in the LPHOEF directive must natch n.(2) 


Argument Descriptions 
Irn 


Tne logical resource number associated with the station. The value 
for Irn {is an integer from 3 through 255. A program nay use this 
numper to tdentify the station when {t requests an innut/outout 
Operation to the station. 


level 


Tne priority level at which the communications supervisor orocesses 
requests for an input/output operation to the station. The value for 
level {s an integer from 7 through 41% it may be the same as the 
level specified for other communtcations stations, but it must he a 
higher number than the communications interruot level(s) ssecified 
in the COMM directive. The level soecified for one or nore 
communications stations may not also be used for noncomnunications 
devices or tasks. 


(1) 
The LPHn directive is also used in conjunction with the Remote 
Batch Facility. See Appendix F. 


(2) 
' The value No. 1 is used to configure the ACTD LPH. 
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X’%channel/ 


A four-digit hexadecimal number (from ’X040n’ to X’FF8n7), 
specifying the channel number of the station and the interrupt 
priority level (n) of the line. The channel number has the 
following format: 


Bits 0 through 9 - Tne !O0-bit channel address of the send or 
receive channel on the line. 


Bits i9 through I13 =~ Must be set to zero. 


Bits t4 and [5 =~ Specifies n, the priority level at which 23 
communications line interrupts the central 
processor. n may have a value of 0, !, 2, or 3 
as specified in the COMM directive. See the 
deseription of the COMM directive for further 
information. 


{ mode xj 


A number specifying the type of data set. Possible values are as 
follows: 


QO =~ Direct connect. 
i = Bell txx=type modem (103A, etc.). Both data-set-ready and 


carrier-detect signals are needed for a connections absence of 
both signals is a disconnection. 


2—~ Bell 2xx=type modem (201A, 2088, ete.). The data~set-ready 
signal is needed for a connection: absence of this signal is a 
disconnection. 


3 or greater - User-defined modem type (see "MODEM Directive", later 
in this section). 


The default value is modem type 2. 
{ speed ] 
The data rate in bits per second. 


For an asynchronous line with a communications=pac whose id is 
21030146), use one of the following values for speed: 


50 300 2490 

75 400 3499 

(default) 110 200 4890 

. 134 1200 7200 
150 {800 9600 
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For an asynchronous line with a communications<-pac whose id is 
2100016), 21100616), or 2118(16), use one of the following values for 
Speeds 


50 200 {800 
75 300 2000 
(default) 110 600 24990 
134 1050 4800 
150 1200 9600 


NOTE: [f the data rate ts $34.5, specify 134. 
For asynchronous terminals you have the option to defer selection of 


the line speed until the terminal comes on=line. You select this 
option by specifying HI or LO. 


“HI? 
Specifies that all terminals associated with this Line will be 
permitted to function only at speeds from 1200 through 9490 
bits per second. 

4L 04 


Soecifies that all terminals associated with this line will be 
permitted to function only at speeds from 110 through 1200 hits 
per second. : 


For more information about the line soeed selection capability, 
refer to the discusston under "Topics Related to CLM Directives" 
near the beginning of this section. 


(¥DX/HDX) 


Specifies whether the line (s full- or half-duplex. If it is 
full-duplex (FDX)}, two channel tables will be assigned. The default 
value {is HDX. 


{liphispecific word] 


A word containing user-defined infornation to be passed to the line 
protocol handler through the station table at offset ZOSSTS. The 
default ts zero. 


Functional Description: 


The LPHn directive must be Lncluded once for each line (i.9e.,. pair 
of channels) of an “YLCP/DLCP on which there are stations to he 
driven by a user-written line protocol handler. An LDBU cirective 
(described in Section V) must be included among the CLM directives 
gO that the Configuration Load Manager will Load the user-written 
line srotocol handler bound untt and execute its initialization 
code. If the sizes of the channel and station tables are different 
from the default sizes for these tables, 3n LPHDEF directive nust he 
included before the related LPHn directive(s). The values snectfied 
in the LPHDEF directive apply only to the LPHn and STATION 
reeled that immediately follow the LPHDEr directive in a CLM 
file. 
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LPHn 


If there is more than one station ona line driven by the 
user=-written line protocol handler, the additional stations on the 
Line must be identified by STATION directives that immediately 
follow the LPHn directive (See “STATION Directive." later in this 


section). 
Examples 


LPHO 8 27,8,X“FD8O" ,,.FDX 
STATION 28,1 


In this example, there are two stations on & synchronous, 
full<duplex line controlled byy a user=written line protocol 
handler. 
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LPHDEF DIRECTIVE ~ 


Jirective Namet LPHDEF 

For each line orotocol handler you write, you can include an LPHDEF 
directive to define the sizes of tables used for the channels and 
stations controlled by the line protocol handler. [f the LPHDEF 
directive is not included, channel table and station table default 
sizes will be used for channels and stations controlled by the line 
protocol handler (see channel_table_size and station_table_size 
arguments below). 


rormat: 


LPHDEF Irh,{channel.table_size]) [(,station_table_stze] 


Argument Descriptions 


Lph 

An integer from 0 through 3 that associates this LPHDEF directive 

with a line protocol handler identified itn one or more LPHn 

directives. 

(channel table size) 

Specifies the number of words needed for the channel table and the 

~QB%s (communications nueue Blocks). [t tust have a value of at 

least 10 words. The default value {s 33 words. 

{station_table_size] 

Specifies the number of words needed for this line protocol 

handler’s station table (resource control table). [t must have a 

value Of at least !0 words. The default value {is 10 words, 

NOTE? The values specified for channel_table_size and 
station_table_size apply only to the LPHn and STATION 
dfrectives that immediately follow the LPHDEF directive ina 
CLM file. 

Examples 

LPHDEF 0,30 
LPHO 27,8,X“%FD80% ,, OX 
STATION 28,1 


In this example, line FD80 has two stations on a synchronous, 
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LPHDEEF 


full-dupplex line controlled by a user=-written line protocol 
handler. Each of the two channel tables for the line has ea size of 
30 words, as defined by the channel_table_size argument in the 
LPHDEF directive. The default value (10 words) is accepted for 
station_table size. 


6~45 


MODEM 


MODEM OIRECTIVE 


Directive Namet YWODEM 

Tne MODEM directive defines a nonstandard modem type. The 
information provided in this directive is used to test entries an 
the appropriate Line control table of the MLCP/DLCP to verify a 
connection or disconnection. 

Standard modem types 3 and 4 have a connect feature for some 
European data sets that require data~terminal-ready to remain low 


until the ring indteator is turned on. This feature is activated by 
setting bit 7 of the dataeset-control argument. 


Format & 

MODEM type _number,connection_ANO_mask ,connaction_ XOR_mask, 
JdJisconnection_AND_mask,disconnection_XOR_ma sk, 
data_set_control 

Argument descriptions 

type_number 

An integer from 3 to 15 that 1s assigned to this modem definition 

and may then be used ia a communications station directive (1.e., 

TTY, VIP, BSC, HASP, RCI, PVE, and LPHn dtrectives). 

connection _AND_mask 

A 2edigit hexadecimal number whose value governs which bits (1i.e., 
from 9 through 3) of line cegister 5 (LR5) will be examined when a 
connect request is processed, 


connection _XOR_mask 


A 2-digit hexadecimal number whose value joverns which bits (from 0 
through 3) of LRS must be ON (t.e., set to 1) for a connection, 


disconnection _AND_mask 

A 2edigit hexadecimal number whose value governs which bits (1.e., 
from J through 3) of LRS will be examined when 2 disconnect request 
1s processed or when a test for the occurrence of a disconnect is 
made. 

discannec tion_XOR_mask 


A dwjigit hexadecimal aumber whose value ygoverns which bits (from 0 
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through 3) must be ON (i.e., set to !) for a disconnection. 


Specifies a 2-digits heaxdecimal number. Bits 0 through 4 are loaded 
unconditionally into bits 0 through of byte 20 of the appropriate 
line protocol table (LCT). The contents of LCT byte 20 are loaded 
into line register 2 of the communications—pac when a line is to be 
connected. 


= 
i data_set_control 
O 
= 


NOTES 3 


1. To test for a successful connection, the contents of LR5 sre 
first subjected to a logical AND operation against the 
(user=supplied) connection _AND_maskt then a logical exclusive 
OR operation is performed on the result of the first 
operation, against the (user-supplied) connection XOR_mask. If 
the result is zero, a connection has been established. 


2. To test for a disconnect, the same Operations are carried out _ 
using the analogous disconnection masks. A zero result 
indicates a disconnection. 


3. The fallowing shows the mask and data set control values for 
the standard CLM-recognized modem types: 


_ Adapter Modem CONNECT ask DISCONNECTION Mask Data Set 


Type Type AND XOR AND XOR Control 
ASYNC 0. X? 80° X7 8S" X780? X “007 X7 80/7 
SYNC ° 0 X? 807 Xx“ 807 X“8O" X*007 X “807 
ASYNC ! X7 OA? X“A0? X7A07 X“007 X780¢ 
SYNC 2 X? 804 X80" X7807 X“007 X7807 
ASYNC 3 X* AO? X¢ AO” X7 AQ? X*907 X“Bi¢ 
SYNC 4 X* 30" X780" X780/ X7007 X“81¢ 


Line register 5 and byte 20 of the LCT are shown below See the 
Communications Handbook for a detailed description of these 
entities. 
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Line Register 5: 
Ne 
2) I 2 3 4 5 6 7 
DATA SET STATUS COMMUNICATIONS=PAC STATUS 
DATA CARRIER 
SET RSU DETECTOR RSU RSU RSU RSU RSU 
READY 
LCT 8yte 20/Data Set Control: 
0 1 2 3 4 5 6 7 
Rs DATA SET STATUS COMMUNICATIONS=PAC STATUS 
Data Synch= Monitor 
' Terminal RSJ RSY RSU ronous RSU RSU for Ring 
Ready Direct Indicator 
4 Connect 
Example !3 
MODEM 34X720% ,X°207 ,X720% ,X700" ,X“88" 
In this example, a modem type requiring only the carrier-detect 
Signal for a connection and absence of this signal for a 
disconnection is defined. 
WH 
Ne 
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POLIST 


POLIST DIRECTIVE 


Directive Name? POLIST 

POLIST specifies the time interval between successive scans of the 
poll list. The POLIST directive must precede the poll list. 
Format? 


POLIST. (poll_cycle_de lay! 


Argument Descriptions 
{pollueye le delay ] 


Defines the time interval in seconds between successive scans of the 
poll list. After completing a scan of the poll list the driver waits 
the specified time interval before re—scanning the poll iist. If 
this parameter is specified, it must be in the range of ! to 16 
(seconds). If not specified, the default is ! (second). 
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PVE DIRECTIVE 


Directive Namet PVE 


The PVE directive {dentifies a polled Vie or STD emulated station on 
a line serviced by the VIP or STD line protocol handler. (1,2,3,4) 


Formats 


PVE lrn, level .X’channel’ , {modem}, poll_address{ ,poll_response) 
{ ,controller_poll_address] 


Argument Descriptions 
irn 


The logical resource number associated with this station. The value 
for Irn is an integer from 3 through 255. A orogram may use this 
number to identify the station when tt requests an input/outout 
Operation to the station. 


(1) 

PVE directives are used in configuring the system at the end of the 
communications Line where polled VIP emulation {fs to be performed, 
The system at the other end of the communications line must be 
configured with a VIP directive for each PVE directives the poll 
address in each pair of directives must be the same. 


(2) 

A single communtcations line Rave up to 32 polled VIP stations. The 
total of 32 may be achieved by any combination of actual VIP 
stations or emulated stations. At your option, up to 32 stations 
may oe combined in groups of 8 when emulating a VIP 7760 line. All 
stations {tn a group must specify the same controller poll address, 
as Lf they were connected to one VIP 7760 controller. 


(3) 

If the station is to be accessible through the file system 
interface, an aopropriate DEVICE directive must be “paired* with 
the PVE directive (see "DEVICE Directive", earlier in this 
section). 


( 4) 
A station can consist of up to 3 addressable components 
(serren/keyboard, ROP, and/or cassette). 
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Lig level 
= The priority level at which the communications supervisor processes — 
requests for an inout/output operation to the station. The value for 
level is an tnteger from 7 through 6/$ it may be the same as the 
level specified for other communications station, but it must be a 
higher number than the communications interrupt level(s) specified 
In the COMM directive. The level specified for one or more 
communications stations may not also be used for noncommunications 
devices or tasks. The level of all PVE stations on a comnon 
MLCP/DLCP channel must be the same. 


X* channel?’ 


A fouredigit hexadecimal number (from X“O40nm to X“FF&n*) , 
specifying the channel number of the station and the interruot 
priority level (n} of the line. The channel number has the 
following formats = 


Bits 0 through 9 = The )0-bit channel address of the send or 
receive channel on the line. 


Bits 10 through 13 = Must be set to zero. 


Bits 14 and 15 =~ Soecifies n, the priority level at which a 
communication line interrupts the central 
processor. n may have a value of 0, i, 2, or 3 
as specified in the COMM directive. See the 
deseription of the COMM directive for further 
information. 


{ modem} 


A number specifying the type of data set. Possible values are as 
follows t 


O = Direct connect. 

2 = Bell 2xx=type modem (201A, 2088, etc.). The data-set=-ready 
Signal is needed for 4 connection’ adsence of this signal ts a 
disconnection. 


3 or greater — User-defined modem (see "MODEM Directive” earlier in 
this section). 


The default is modem type 2. 

poll address 

Soecifies the poll_address of this station on the line identified by 
the channel argument. The sollladdress argument is an integer from 9 


through 31. Each station on the line must have a unique 
poll_address. 
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{poll_response] 


Specifies the type of response that PVE will generate if a select 
and/or poll is received for a station that is not logically 
connected. The possible values are? 


QA - If a non=-connected station is selected to receive data, PVE 


will respond to the subsequent 90ll with a positive 
acknowledgement (ACK). 


If a non-cannected station ts simply polled, PVE will respond 
with a quiescent (0) frame. 


QN = If a non-connected station is selected to receive data, PVE 
will respond to the subsequent poll with a negative 
acknowledgement (NAK), 


If a aon-connected station ts simply polled, PVE will respond 
with a quiescent (Q) frame, 


Default No response to poll. 
(controller_pollladdress] {VIP 7760 only} 
The controller poll address associated with this station on the 
lines {t equals the poll address of the VIP 77460 controller to 
which this station is connected. This station emulates a VIP 7760 
station having the same controller poll acdress. 
controller_poll_address must be an integer ranging from 0 through 7. 
Several stations on the line may have the controller poll address. 
Default! No controller poll address 1s assigned for this station. 
Examples . ae 

PVE 30,9,X’FDO80".,0 

PVE 31,9,X*FD80",,! 

PVE 32,9,X“%FD80%,,2 
In this example, three polled VIP emulated stations are defined for 
a conmunications line (FD8O). Each station has a unique lrn and 
polluaddress.' The default value (2) is eastablished for modem type. 
The system at the other end of the communications line must be 


configured with VIP directives for the same ohysical line: each 
pollladdress in a VIP directive (in system "A", 
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RC 


RCI DIRECTIVE 


Directive Namet RCI 


’ The ROI directive identifies a station on @ line serviced by the 
Remote Computer Interface (RCI) line protocol handler.( 1) 


Formats 


RCI IUrn,level,X’channel/ ,{modem } 


Argument Description? 
Irn 


The logical resource number associated with the station. The vaiue 
for Irn is an integer from 3 through 255. A program may use this 
number to identify the station when it requests an inout/outout 
Operation to the station. 


level 


The priority level at which the communications supervisor processes 
requests for an input/output. operation to the station. The value for 
level is an integer from 7 through 6/% it may be the same as the 
level specified for other communications stations, but is must be 4 
higher number than the communications interrupt level(s) specified 
in the COMM directive. The level specified for one or more 
communications stations may not also be used for noncommunications 
devices or tasks. 


(1) 

If the station is to be accessible through the file system 
interface, an appropriate DEVICE directive must be “paired” with te 
RCI directive (see "DEVICE Directive", earlier in this section). If 
input/output of the station is to be asynchronous, the B (buffered) 
argument must be tnceluded in the DEVICE directive. 
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X’channel’ 


A A four-digit hexadecimal number (from X“740n% to X“FF8n7) 
specifying the channel number of the station and the tnterrupt 
priority level (n) of the line. The channel number has the following 
formate 


Bits O through 9 - The |lS5=<bdit channel address of the send or 
receiva channel on the line. 


Bits 10 through 13 = Must be set to zero. + 
Bits 14 and 15 ~- Specifies n, the priority level at which a 
communications line interrupts the central 


processor. nm may have a value of 0, i, 2, or 3 
as specified In the COMM directive. See the 


description of the COMM directive for further 
information. 
{ modem 


A number specifying the type of data set. Possible values are as 
followst 


O ~ Direct connect. 

2 =~ dell 2xx-type modem (201A, 2088, ete.). The data-set~-ready 
signal is needed for a connections adsence of this signal is a 
disconnection. 


3 or greater - User-defined modem type (see "MODEM Directive", 
earlier {in this section). 


The default value is modem type 2. 
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——/ 
ROP DIRECTIVE 
Directive Name: ROP 
The ROP directive specifies that a receive-only printer (ROP) is 
connected to a station on a line serviced by the STD line protocol 
handler. (Sse the STDLN directive for information on how to speci fy 
ROP directives in a CLM file). 
Formats 
ROP rop type 
Argument Descriptions 
Ne 
rop type 
Specifies the type of recelve-only printer device that is connected 
to the station. Possible values for this argument are? 
corresponding 
rop type, device type 
1003 PRUI0O3 : a 
1005 PRU] 005 
T™N 300 TermiNet 300 
TB1200 TermiNet 1200 
Qne value for rop_type must be specified. 
Sai 
we 
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STAPOL 
 STAPOL_ DIRECTIVE 


Directive Name! STAPOL 


The STAPOL directive defines the order in which stations are polled 
on a line serviced by the STD Line protocoi handler. The order in 
which stations are polled {s determined by the position of arguments 
in the STAPOL directive. (See the STDLN directive for example). 


rormatt 


STAPOL station_poll_address (,station_poll_address ] 
2 


eoeseseelt station. poll_address |] 
15 


Argunent Description: 


station_poll_address 
n 


Specifies the poll address of a station on this line. Up to 15 
station voll addresses may be specified. The station poll addresses 
Nust have been previously specified tn the STD directive associated 
with this line. The value of this argument must be itn the range 0 
through 31. It may be specified as many times as is necessary to 
create the polling priority list for the Line. 
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STATION DIRECTIVE 


Directive Name? STATION : 


The STATION directive tdentifies the second or subsesuent station(s) 
on a line controlled by a userewritten line protocol handler that 
drives multiple stations per line. One station On the line must be 
identified py an LPHn directive: additional stations are identified 
by STATION directives, one oer station, immediately following the 
related LPHn directive (i). (See the Len directive for an examole?. 
STATION directives and LPHn directives must immediately follow the 
LPHDEF directive that defines them in a CLM file. 


Format? 


STATION Irnl,lphispecific word) 


Argument Description: 
ira 


The logical resource nunber associated with the station. The station 
for Irn ts an integer from 3 through 255. A Drojram may use this 
number to identify the station when it requests an input/output 
operation to the station. 


{(lnphusoecific word] 


Specifies a word containing user-defined information that is to be 
9assei to the line protocol handler through the station table, at 
offset ZOSSTS. Tne default is Q. 


NOTE: The priority level, cnannel nummer, modem type, Line speed, 
and line procedure (fOX/HDX) of stations described in STATION 
directives are obtained from the LPHn directive that precedes 
the STATION directive (See “LPHn Directive", earlier in this 
section). 


] 

For aiditional (polled) ViP%’s on a line, use additional VIP 
directives with the sane ievel and channel number, rather than 
STATION directives. 
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STD J(RECTIVE (1) 


Jirective Names STD 


The STD directive identifies a station on a line serviced by the 
synchronous terminal device (STD) line protocol handler. See the 
“STOLN directive for examples. 


Formats 


STD Irn,station_poll_addressl ,,device_tyoe] 


Argument Deseription® 
irn 


The logical resource number associated with the station. The valite 
for lrn is an integer from 3 through 255. A program may use this 
number to identify the station when it requests an itnout/outout 
Operation to the station. 


station _poll_address 


Specifies the poll address of this station. The poll address its an 
{nteger from 0 through 31. Each station on the line must have a 
unique station_poll_acdress. 


(device_type) 


Specifies the tyoe of VIP terminal used. Possible values for 
device_type ares 


C1} 

Tne STD directive and the VIP directive suocort synchronous 
terminals. The line protocol handler called by the STD directive 
offers additional suovort canabilities (e.g., suoport of VIP7804 
and VIP7805 terminals) not offered by the line protocol handler 
called by the VIP? directive, 
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device type corresponding 
terminal type 


V7804 VIP 78047VIP 7805 
V7700 VIP 7700/VIP 7700R/VLP 7705R 
V7760 VIP 7760, DKU 7005, DKU 7007 


If this argument is not specified, the default device _type is V7700. 


When using the Synchronous Terminal Driver (STD) line protocol 
hendlier, you must observe the following: 


« The master LRN station must be the last station to be 
disconnected. 


e The 7804 Control Byte Head of Form supsort translates to a 7804 
clear escape sequence. This sequence, in addition to 
positioning the cursor to the Home row, puts the 7804 in text 
node © 


« 10 use the STO LPH, the VIP 7804 hardware switches must be 
configured as followss 


Reset, Text Mode, Verify before process, 
Transmit next block. 
Uotional settings are? 

Roli/No Rell 

Space/No Space 

Return = Transmit/Normal 

Set Block Size 


« VIP 7804 terminals are not compatible with VIP7700 terminals in 
the handling of end-of-—message CR’%s and LF’s. It is recommended 
that the new STD line orotocol handler be used for VIP7804 
supoort. If the VIP line protocol handler {is used to supoort a 
VIP7804 terminal, the following must be observed: 


i. RETURNSNORMAL must be selected at the terminal. 

2. The XMT key should be used to enter commands. 

3. When using the Editor, Linker, or other utility directives 
with the prompt option, the RETURN key should be depressed 


before the SMT key. This will assure that the promt appears 
on the next line rather than at the and of the current line. 
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STDLN DIRECTIVE 


Directive Namet STDLN 


The TSULN directive identifies a line serviced by the STD line 
protocol handler. (The STDLN directive does not supoort floating 
channel number assignments. You must explicitly specify the channel 
number argument). 


rormat: 


STDLN level,xX’channel’,{modem],{soeed](,2/4 wire) 


Argument Description: 


level 


The priority level at which the communications suoervisor processes 
requests for an tnout/output operation to the station. The value of 
the tevel is an integer from 8 through 58% itt may be the same as the 
level soecified for other communications stations, but it must be a 
higher number than the communications interrupt Level(s) specified 
im the COMM directive. The level specified for one or more 
communications stations may not also be useJd for non=comnunications 
devices or tasks. 


X*%enannel 


A four-digit hexadecinal number (fron X%40n’% to X“FF8n%), specifying 
the cnannel number of the station and the interrupt priority Level 
(n) of the line. The channel number has the following format: 


Bits 0 through 9 ~ The [O-bit channel address of the send or 
receive channel on the line. 


Bits !0 through 13 = Must be set to zern. 


Bits 14 through 15 = Specifies n, the oriority level at which a 
communications line tnterrupts the central 
processor. n may have a value of 0, 1, 2, or 3 
as spectfied {tn the COM” directive. See the 
deserioation of the COMM directive for further 
information. 
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{ modem] 


A number specifying the type of data set. Possible values are as 
follows: 


O = Direct Connect 


2= Bell 2xx-type modem (201A, 2088, ect.). The data-set-ready 
signal is needed for a connections absence of this signal is a 
disconnection. 


+ 


3 or greater = User=defined modem (See “MODEM Directive", in this 
section). 


The default is modem type 2. 
{ speed] . 


The data rate in bits per second. The default value is 2000. (Other 
possible values for speed include. 


2400 
4800 
9600 
19290 
(2/4 wire] 
Specifies a 2 Or 4 wire connection. Possible vaiues ares 


. Value meaning 


(Default) wW2 2-wire connection 


N4 4-wire connection 


Functional Descriptions 


The STDLN directive defines a line serviced by the STD line orotocol 
handlers it precedes all other directives which characterize this 
line. Configuring a line serviced by the STD line protocol handler 
requires that at least four different directives be specified for 
the line and all stations on the line. These directives must be 
specified according to the following guidelines: 


Required directives 
STOLN (specify one for each line) 

‘STD (specify one for each station on the line) 
POLIST (specify one for each line) 

STAPOL (specify one or more as needed?) 


JUptional directive 


ee eon EE ee Go ae ee 


ROP 
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Sequeace rules 


The following diagram illustrates the sequence rules that aoply when 
specifying STDLN and other STD directives. One set of these 
directives mist be soecified for each line. Note that all directives 
which characterize the line must immediately follow the STOLN 
directive that identifies the line. Brackets enclose optional 
directives. 


STOLN must specify one for each line 
STD 

I 

specify one set for each 
(ROP) specify one for each station on the Lines all must 
station, if needed precede POLIST 

STO 

2 
CROP] 
POLIST must specify one for each Line 
STAPOL must specify one or more 


for each linet all STAPOL 

directives should be specified ; 
in the order in which stations males 
are to be solled 


Examole I: 


STILN 20,X“FCOO’ ,,2400,N4 
STD 20,!.,V 7304 

ROP IN300 

STD 21,2,,V 7804 

RIP ROSY26 

STD 22,3,,V7804 

POLIST 5 

STAPOL 1,2,1,3 


In this example, an STD line has been configured with three 
stations. As specified in the STDLN directive, this line’s reauest 
level ts 20, the channel number is FCOO, the default modem used is 
type 2, the line sused is 2400 bits ser second, and the line 
connection is 4-wire. All three stations support VIP7804 terminals. 
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STDLN 


The first station has an Irn of 20, a poll address of |, and 
includes a IN300 ROP. The sscond station has an Irn of 21, a poll 
acdress of 2 and includes a PRU 1005 ROP. The third station has an 


Irn of 22, a poll address of 3 and mo RUP. The POLIST directive sa 
identifies the start of the poll list and specifies a S=second delay 
between that the station with poll address | (irn 20) is polled 
twice as often as the other two stations, imlying that this station 
has higher priority. 
Example 2% 
$sY¥s eeeacedcoe® 
STOLN 10,X¢%FFOO’ ,2,2400,N4 
STD 20,0,V7805 
RVeP ROSY26 
STD 2!,1,V7804 
3TD 22,2 
PULIST 2 ed 
STAPOL 0,1,0,2 
DEVICE STDOO,20,10,X“Frad’ .V7805,80,8 
DEVICE STDO2,21,50,X*Fr00’ ,.V7804, 80,8 
DEVICE STDO3,22,10,X*Fr00’ .V7700,30,8 
The above example describes an’ STD line connected to the system 
through address “FFOO", with an interrupt level of !0. The line uses 
a type "2" modem at 2400 baud and is a 4-wire connection. There are 
three VIP“%s om the line. The terminals will be polled in the 
following sequence for data? 0,!,0,2% after which there will be a 
delay of two seconds before they are oolled for data again. Address 
“Oo well be palled twice as frequently as the other two terminals. 
All of the devices are configured for the file system, as shown in 
the DEVICE directives. (The DEVICE directives may appear anywehere 
in your CLM file). 
Nae” 
None 
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STTY JIRECTIVE 


Oirective Namet STTY 


The STTY directive specifies the file characteristics of a device 
that ts not a disk device or a private device. The characteritics 
specified by this directive override the default characteritics 
estadlished by the associated DEVICE directive (or the 
characteristics established Sy a previous STTY directive). The STTY 
command keyword format (as described in Appendix D) may be used as 
an alternative to the STTY directive format {in your CLM file. 


Formatt 


device_unit 
STTY device_name, (Lengthi ,(D’dsw an “},{detab],Cin], 
l 


Cout)] [(,typel 
Argunent Descriptions 


jasticsoeeet 
de vice_name 

This antry, which identifies the device, must be the same as One 
entered in a previous DEVICE directive. {if device_name was specified 
in a orevtous DEVICE directive, it must be entered here: i.a., the 
entry of device_unit will result in error. The device_unit and 
device_name arguments each consists of a string of ASCII characters 
as described under the DEVICE directive. [f there is no previous 
DEVICE directive having the string specified here, an error message 
is generated. 


Cleagtn! 


An integer giving the line length (record size)? tn bytes. 


(1) . 

You must use the STTY command format in your CLM directive file if 
you wish to configure a device that can be automatically 
reconnected if a vower resumption or line drop condition occurs. 
See Appendix D for information on how to configure devices 4s 
reconnectable. The STTY command format is dascribed in Appendix D,. 
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STTY 


(D%dsw dsw ¢] 
H 2 


Specifies the terminal’s device specific words for 
cannect/disconnect (dswl) and read/write (dsw2). The values of dswl 
and dsw2 are expressed in double-word format as a pair of 
4-character hexadecimal numbers enclosed in apostrophes. 


dswl specifies certain characteristics of a device at open (connect) 
Or close (disconnect) time, as shown in Table 4-4 and 646. Refer to 
these table when defining the I4=—bit settings for dswi that 
characterize connect/disconnect functions. 


dsw2 specifies certain characteristics of a device when reading or 
writing to a file, as shown in Table 4-5 and 6-6. Refer to these 
tables when defining the IiS=—bit settings for dsw2 that characterize 
read/write functions. 


If dswi and dsw2 are not svecified, certain default values are 
assumed. Default values are listed in Table 6-7, 


NOTE? The STIY command keyword format (as described in Appendix D) 
may replace the STTY directive format in your CLM file. When 
used at CLM time, either STTY format will cause the initial 
dswl and dsw2 assignments (as well as the current device 
specific word assignments) to be modified. However, if the 
STTY command is specified at any time after system 
initialization, only the current device specific word ~ 
assignments will be modified. Only at system building (CLM) 
time will the STTY directive format or the STTY command 
keyword format modify both the current and the initial device 
specific word assignments.(}) 


Cdetab) 
An alphabetic string that controls tabulation 


-ON Tab characters in the input stream are deleted and replaced by 
the number Of spaces required to bring the cursor (or printer) 
to the next tab position. Tab positions are set by the MOD 400 
system in increments of 10 (to print positions II, 21, 3f,...) 
and cannot be changed by the user. 


“OFF Tab characters’ in the input stream are not replaced by spaces. 


CH) 

In @ diskette=based system, using the STTY command format in your 
CLM file results in the loader error §609. If you wish to use the 
STTY command format in your CLM file, you must create a directory 
ae the system root named SYSLIB2 and load in it the bound unit 
=) = 
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Cin] 


An alphabetic character specifying the type of input accepted by the 
davice. 


A = The device its to receive asynchronous input 

S = The device is to receive synchronous input 

N = The device is to receive nonbuffered synchronous input 
(out) 


An alphabetic character absences the type of data transmitted by 
the device 


A = The device transmits asynchronous output 

S ~ The device transmits synchronous output 

N - The device transmits nonbuffered synchronous output 
(type ] -—~ 
An alphabetic character spscifying the device type 

I - The device is an inout device ee 


= The device {Is an output device 


B= The device ts bidirectionalt it raceives and transmits 


Messajes 


Crror nessages that may be issued during execution of this directive 
are as follows? 


133—& CMD CSTTY) ERROR. No previous DEVICE directive. 
133F CMD (STTY) ERROR. Invalid detab argument. 

134i CMD CSTTY) ERROR. Invalid in or out argument. 
1342 CMD (STTY) ERROR. [Invalid type argument. 


Device Specific Words for Communications Devices 


Table 6—4 list the bit settings for dswl, the device specific word 
for connect/disconnect functions. Table 6-5 lists the bit settings 
for dsw2, the device specific word for read/write functions. Use 
these tables in conjunction with Table 6-4 to determine the 
definitions of each bit. 


If you do not wish to specify dsw! and/or dsw2 in the STTY 


directive, the system assumes certain default values for them. Refer 
to Table 6=7 for a list of device specific word defaults. 
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Table 6-4. Values for dsw! 


were 


whE 8 


CONNECT ~ 


DESCONNECT 


tcc oet 


ieeitien 


10 


READ 
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Table 6<6, 


If bit = Of 


Dequeue remaining [OQRB/s 
for channel 


dlock made not supported 


Buffer anode is single-block 


ETX mode (ATD Block mode 
anly) 


Send eR after text of mes~ 
sage (Not supsorted for 
ssoervisory message reads 
by ATD) 


No space sunpress 
(VIP 7801) 


No Auto-dial used 


Roll (VIP 7801) 


Jon’t echa input characters 


~ 


No time-out for read 
Don’t save in read [ORB 
functio.. codes recetved in 
text header 


Jon’t abort read [08B 
requests (ATD}) 


Use 8SC2780 orotocol 


Don’t abort read/write 
requests 


Hanj up the phone on 
disconnect 


Jon’t abort write [UuRB 
raquests (ATD) 


control word present for 
read/write 


Bit Definitions 


,11¢ 


If bit = 183 


Don’t dequeue remaining [ORB/s 
for channel 


ATD Block mode suoported 

Buffer mode {is double-block. 
(Notes Nouble=-block is not suo@- 
ported by file manager) 


ETB/ETX specified on write (ATD 
Block mode) 


Don’t send CR after text of : 
mess3ge 


Space suppress (VIP 7801) 
applicable in block mode) 


(Only 
Use Auto-dial handler to dial 
connection 

No roll (VIP 7801) 

Echo innut characters 

Time-out for read (immediate) 
Save up to 2 function codes 


received {n taxt header 


Abort read [ORB requests (ATD) 


Use 3780 protocol 


Abort read/write requests 


Don’t hany uo the shone on 
disconnect (ATD Block mode) 


Abort write [ORB requests (ATD) 


No control word for read/write 
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. Table 6-6 (Cont). Bit Definitions 


BIT If bit = O# 


Don’t suoport preemptive 
write 


Don’t set VIP 7804 CRT 
space suppress 


Send a block ended by ETX 
Set VIP 7804 CRT roll mode 


Don’t send LF after text of 
message (Not supported for 
supervisory message reads 
by ATD) 


Jata mode is non= 
transparent 


Don?t set BIP 7804 CRT to 
block mode (RECV) 


Set transparent printer 
mote 


Not reserved for cross= 
compatibility with STD iph 


Quit on receiving break 
(Not supported for super= 
visory message writes by 


“ATO 


Buffer mode is not multi= 
block 


Don’t send EQT characters 
Don’t sunpoert DLE E0T 

Send ITB and ETB characters 
Include control byte 


Don’t send OLE EQT for 
Vie 7804 


No echoplex (VIP 7801) 


Don’t send RVI characters 


If bit #2 


Support preemptive write (ATD 
Block mode only) 


Set VIP 7804 CRT space suppress 


Send a block ended by ETB 
Don’t set VIP 7804 CRT roll mode 


Send LF after text of message 


Data mode is transparent 


Set VIP 7804 CRT to block mode 
CRECV) 

Set non-transparent orinter mode 
Reserved for cross=-compatibility 


with STD Iph 


Don’t quit on receivinae break 


Buffer mode is multi-block 


Send EQT characters 

Support DLE EOT 

Send ETX characters 

Do not include control byte 


Send DLE EOT for VIP 7804 


Echoplex (VI? 7801) 


Send RVI characters 
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Table 6-6 (Cont). Bit Definittons 


If bit = O08 


[Include received DEL 
characters in buffer 


dome cursor on page over= 
flow 


Include control byte as 
first byte 


Include ATTENTION character 


Return key equal transmit 
key 


Transfer mode is character 


If bit 2 Js 

Strip received DEL characters 
Don’t home cursor on page 
overflow 


No control byte (first byte is 
data) 


Exclude ATTENTION character 


No specific meaning to return key 


Transfer node is page 


VIP 7804/5 Printer copy 


Q00 = | copy 010 = 3 coples i00 = 5 coptes 


QO = 7 cootes 
OOi = 2 copies Ol = 4 cosies 101 = 4 copies 1 


= 8 coples 


P Logical Poll interval 


000 = 0 sac O10 = 2 sec 100 = 4 sec 
90t = } sec Otl = 3 sec 101 = 5 sec 


R Logical read time-out interval (poll duration): 


i0 = O min if # reserved for 
future use 


00 = 10 min Ol # no time-out 
w,x LPH response to application when LPH recelves data but no 
real [ORB available, VIP status codes? 


OG = Send NAK 10 = Return busy status 
Ot = Send ACK it 2 Send NAK (same as 00) 


NOTES + 
1. O tndicates that you cannot use the bit. 
2. This table is organized by function for conventfence onlys 
there is no overlapping of bits. dswi sets all bits for 


cannect/disconnect functions. dsw2 sets all bits for 
read/write functions. 
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Table 6-7. System Defaults for dswl and dsw2 


2 


0030 
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TTY 


TTY DIRECTIVE (1) 


Directive Namet TTY 


The TTY directive identifies a station on a line serviced by the TTY 
(teleorinter) line protocol handler. The TIY directive supports 
asynchronous terminal devices as teleprinter-compatible devices. You 
may float the channel assignment in this directive, if you wish. 


Formatt 


TTY Irn,level ,X’%channel’ ,{modem],(speed]{ ,“device=-type7 ] 


t 


Argument Desertptions 
irn 


The logical resource number associated with the station. The value 
for Irn ts an {nteger from 3 through 255. A program nay use this 
number to identify the station when it requests an input/outout 
operation to the station. 


(1) 

The TTY directive and the ATD directive support asynenronous 
terminal devices. The line protocol harmiler called by the TTY 
directive supports the physical terminal only in telesrinter mode. 
The TTY line orotocol handler does not orovide hlock mode support 
of VIP7300 devices: either does it provide support for VIP 7200 
devices and VIP 7800 devices in forms processing mode. (For these 
functions the ATO directive ts reoulred).- The ATD line protocol 
handler does not provide the transparent resd [/) or single 
character mode functions Of the TTY line pratocol handler. The 
number of words of resident menory reauired by the TTY line 
protocol handler is less than the number of words of resident 
memory required by the ATD line protocol handler. See the WoO 490 
Executive Software Release Bulletin for comparative figures. 
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> level 


Z The priority level at which the communications supervisor processes ce 
requests for an input/output operation to the station. The value of 
level is an integer from 7 through 61% it may be the same as the 
level specified for other communications stations, but it must be a 
higher number than the communications interrupt level(s) specified 
In the COMM directive. The level specified for one or more 
communications stations may not also be used for noncommunications 
devices or tasks. 


X*’ channel? 


You may specify a single zero(0) to float the channel number 
assignment or a four-digit hexadecimal number (from X“040n’% to 
X*PF3n%), that specifies the channel number of the station and the 
Interrupt priority level (n) of the line. The channel number has 
the following formats 


Bit O through 9 - The Il0-bit channel address of the send or 
receive channel on the line. 


Bits 10 through 13 = Must ba set to zero. 

Bits 14 and {5 = Specifies n, the priority level at which a 
communications line interrupts the central 
processor. mn may have a value of 0, 1, 2, or 3 
as specified in the CO™M directive. See the 
description of the COMM directive for further 
information. 

(modems 


A numSer specifying the type of data set. Possible values are as 
follows % 


0 - Direct connect, 

i = Bell Ixx=type modem (103A, etc.). Both data-set-ready and 
carrier-detect signals are required for a connections ahsence of 
these signals is a disconnection. 


3 or greater = User-defined modem type (see "MODEM Directive", 
earljer in this section). 


The default value is modem type |. 


6=74 


( speed) 


AIT 


The data rate its bits per second. 


For an asynchronous Line with a communications-pac whose id is 
21038(16), use one of the following values for sseed: 


50 300 2400 
75 600 3600 
(default) 110 900 4800 
134 1200 7200 
150 1800 9600 


For an asynchronous line with a communications-pac whose id is 
21006146), 2110016), or 21318016), use one of the following values for 
speed? 


50 200 1800 
75 300 2900 
(defauit) 110 600 2400 
134 1050 4800 
150 1200 94600 


NOTE? [f the data rate is 134.5, specify 134. 


You have the ontion to defer selection of the Line speed until the 
terminal comes online. You select this option by specifying HI or 
Lo. 


*HI? 


Soecifies that all terminals associated with this line will be 
permitted to function anly at soeeds from 1200 through 9400 
bits oer second, 


#104 


Specifies that all terminals assoctated with this line will be 
oermitted to function anly at speeds from 119 through 1200 bits 
per second. 


For more information about the Line sneed selection capability, 
refer to the discussion under “Topics Related to CLM Directives" 
near the beginning of this section. 


> (“device-type/] 


a Specifies the type of terminal used. [If this argument is not 
specified, the default is TTY. Possible values are? 


Va lue Physical devices supported 

7200 VIP 7200, VIP 7205 

7801 VIP 780!, VIP 7802 

PRU PRU 100i, PRU 1003, PRU 1005, 
TWU 1001, TWU 1003, TWU 1005 

neers bp f An asynchronous terminal that 
is to be supported as teleprinter= 
compatible. 
Example 13 


TTY 21,8, X% FF807 

DEVICE TTYO1 ,2!,3,X*FF80"% , TTY! 
In this example, the TTY is cannected by a Bell Ilxx=type modem and 
operates at 110 bits per second. Default values for modem tyoe and 
line speed have been used. The TTY is to be accessible through the 
Tile system interface (by virtue of the DEVICE directive). 
Example 23 

TITY 22,8, X° FFQ0% ,0, 1200 

DEVICE © TTY02,22,8,X“FFOO’ ,TTY2 
In this example, the TTY is connected by a direct cable connection 
and operates at 3200 bits ser second. These characteristics are 


reflected by explicit arguments in the TIY directive. Again, the TTY 
to be accessible through the file system interface. 
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VDAM DIRECTIVE 


Directive Namet VDAM 


The VIAM directive must be specified if the Disolay Formatting and 
Control software is to be used. This directive causes the software 
component to be incorporated in the configuration(!}. You must 
configure the Display Formatting and Control Sofware if your 
installation will suoport DEF—II or DEF=II and TCLF. See Appendix P 
for further {tnformation on configuring the Display Formatting and 
Control Software, 


format? 


VOAM clirn,levell{,maximum terminals] 


Argument Descriptions 
lrn 


The logical resource number assoctated with the VDAM task. The value 
for lrn is an integer from 3 through 255. This value must be 
specified if asynchronous VDAM processing ts destred. The next two 
sequential Irns w{ll be reserved for’ VDAM processing. 


level 


The priority level at which VDA processing onerates. The value for 
level must be an integer from 7 through 4!. This value must be 
specified if asynchronous VIAM processing is desired. 


NOTEs Both Irn and level must be specified, or neither argument 
should be specified. [{f neither one is specified, the default 
- is that not asynchronous instructions are issued to VDA. 


(maximum terminal J 


The maxtinum number of terminals that use VDAM processing in One task 
grouo. If a number is not svecified, the default value ts 1/0, 


NOTE& When using VOAM with Block Mode Terminals ft.e. OKU 7005 or DKU 
7007 (configured using an STD directive) another bound unit 
must be loaded via: 


LDBU ZNV77F 


J 

Display processing requires VIP 7200/7205 or VIP 7301/7802 

bilieh Seat The terminals can be configured using an ATD or 4 V7200 
directive. 
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VIP DIRECTIVE 


Directive Names VIP 


The VIP directive identifies a polled or nonmpolled visual 
information projection station on a line serviced by the VIP line 
crotocol handler. Optionally, the VIP directive identifies ea ROP 
(receive-only printer) station on the same line. (1,2,3,4} VIP 7700, 
VIP 77OOR/7705R, VIP 7804/7805 (in VIP7700 mode) and VIP 7740 
terminals are supported. You may float channel assignments in this 
directive, if you wish. 


Format t 


C 
VIP Irn, level,X’%channel’ ,{modem] ,Coollvaddress], {$}] ° 
CROPLI rn], CROP_type} € ROPLform_feed] 


(}) 

The VIP directive and the STD directive both support synchronous 
terminals. The line protocol handlér called by the STD directive 
offers additional support capabilities (@.g., support of VIr7804 
and VIP7805 terminals} not offered by the line protocol handler 
called by the VIP directive. 


(2) 

If the Configuration Load Manager detects an error in a VIP 
directive, the error must be connected in the CLM=-USER file and the 
system bootstrapped again. 


(3) 

If the station is to be accessible through the file system 
interface, an aopropriate DEVICE directive must be “paired” with 
the VIP directive (see “DEVICE Directive", earlier in this 
section). 


(4) 

If a “remote"® system is to perform volled VIP emulation, see “PVE 
Directive", earlier in this section, for a description of the 
relationshio between VIP directives for the “lLocal"® system and PVE 
directives for the “remote* system. 
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Argument Deseription? 
irn 


The logical resource. number associated with the station. The value 
for lrn is an integer from 3 through 255. A program may use this 
number to identify the station when it requests an input/outout 
Operation to the station. 


level 


The opritority level at which the communications supervisor vrocesses 
requests for an input/output operation to the station. The value for 
level is an tnteger from 7 through 4I1% it may be the same as the 
level specified for other communications stations, but it must he a 
higher number than the communications {interrupt level(s) specified 
tn the COMM directive. The level specified for one or nore 
communications stations may not also de used for noncomnuntcations 
devices or tasks. 


The level for all solled VIP%s on a common MLCP channel must be the 
same. 


X’%channel 


You may specify a single zero (0) to float this channel assignment 
Or a four~digit nexadecimal number (from X7040n’ to X“FFEN’), that 
specifies the channel number of the station and the interrupt 
ortiortty level (n) of the line. The channel number has the 
following format? 4 


Bits O through 9 - The !0~bit channel axtiress of the send or 
receive channel on the line. 


3its 10 through 13 = Must be set to zero. 


Bits !4 and 15 ~ Specifies n, the oriority level at which a 
communications line interrupts the central 
processor. on may have a value of 0, 1, 2, or 3 
as specified {nm the COMM directive. See the 
deseriotion of the COYM directive for further 
tnfornation. 


{ modem] 


A number specifying the tyoe of data set. Possible values are as 
follows: 


QO =~ Jirect connect. 
2- sell 2xx=type modem (201A, 2088, etc.). The data~set-ready 


signal is needed for a connectiont absence of this signal is a 
disconnection. 
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1. 


Vi 


3 or greater = User=defined modem tyne (see “YODEM Directive”, 
earlier in this section). 


The default value is mode type 2. 
Cpoll_address) 


Specifies the address of the VIP station on the line specified by 
the channel argument. The value for sollvaddress is an integer from 
0 through 3!. If no polling address is specified, no polling can 
Occur on the linet in this case, only one VIP station can be on the 
line. 


{S 

14 

This argument is meaningful in only two situations: 

(1) a file-transnission (nonpolled) environment and 

(2) a nOnpolled environment wherein the VIP is to be accessible 


through the file systen interface. (In the second situation, the VIP 
directive must be "paired" with an appropriate DEVICE directive). 


C specifies that the central processor is the control stations T 
specifies that the central processor is the tributary station. The 
tributary station nust send the first Q (quiescent) frame on the 
line. The default value is Cc. 


Cin the nonpolled, file system access environment, T should be 
specified in the VIP directive in order to avoid excessive delays in 
Lnput/output overations). 


CROP_Lirn} 


Specified the logical resource number of a receive-only orinter 
connected to the VIP controller. The value for ROPLIrn its an integer 
from 3 through 252. The default is that no receive-only printer Is 
eonnected to the VIP controllers in this case, the 20P_tyse and 
ROP_form feed arguments must not be specified. 


CROP_type ] 


Specifies the type of receive-only printer. Choose from one of the 
following? 


ROP_type Corresponding 
Jevice_type 


a ee ap —_ com Cree a er oo ao ceo 


IN390 (default)  TermiNet 300 or °RUI1003 


T1200 TermtNet i200 or PRUIDO5 
TTY 33 ASR=33 
TTY35 ASR~ 35 
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CROP form_f eed} 


Specifies whether the receive-only printer has a form=feed ontion. 
FORM or FU indicates that the receive_only_orinter does have the 
form_feed Option’ NOFORM or NO indicates that 1t does not have the 
forn_feed option. 


The default its that TermiNets have the fora_feed option and the 
TTY’s do not have the form_feed option. 


NOTE? The following rules only to Lines that have more than one VIP 
station (1.e., a pollad VIP environment)? 
(1) a separate VIP directive is reauired for each station on 
the line, 
(2) the VIP directives be consecutive, and 
(3) the logical resource numbers of the stations on the line 
Must be consecutive. 


Examo lest 
In the followtng examples, VIP stations are connectad by Bell 
2xx~=type modems. Default values for modem tyse have been used. 
DEVICE directives are “paired” with the VIP directives because the 
VIe’s are to be accessible through the file system interface. 
Examole |: 

VIP 23,8,X“FE80" ,,0 

DEVICE VIP00,23,8,X°FE80% ,VvIPO 
in this example, the V{P has a polliaddress of ©. 
Example 2: 

VIP 24,38.X7F E90" ,,1,,25,TNI200 

DEVICE VIPO1 ,24,,8,X“%FE80% , VIP) 

DEVICE ROPO!},25,.3,X“FES80% ,Q0P | 
In this example, the VIP has a coll_asadress of 1. In addition to the 
.VIP screen, the VIP controller has a TermiNet 12090 as a recetve-only 


printer. The VIP screen’s logical resource number is 24 amd the 
receive-only printer’s logical resource number {s. 25. 


-~-° 
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VROSY/VTTY/V7200 


VROSY, VITY, AND ¥7200 DIRECTIVES (1), (2) 


Directive Name: VROSY, VITY, or V7200 


These diretives define devices that are on lines serviced by the ATD 
line protocol handler. Except for the directive name, the format is 

the same for all three directives. You can float channel assignments 
in these directives. 


Format 
VROSY 
VTTY Irn,level ,X’“channel’,{modem],{speed],(device_type), 
V7200 fdell,€stop_bit] (,parity] 


Argument Descriptions 
ira 


The logical resource number associated with the station. The value 
for Irn is an integer from 3 through 255. A program may use this 
number to identify the station when it requests an input/output 
operation to the station. 


(1) 

. Tne ATD directive intended as a remplacement for the VROSY, VTTY, 
and V7200 directives. The line protocol handler called by the ATD 
directie offers additional supsort capabilities (e.9., block mode 
support af VIP7801/7802 devices, support of the VIP7207 device) not 
V7290 directives. The VROSY, VITY, and V7200 directives can still 
Ke iy The directives, however, call the ATD line protocol 

andler. 


(2) 

Tne ATD directive or the 7200 directive must be specified if 
VIP7200/7205 or VIP7801/7802 terminals are to be used for forms 
processing using HONEYWELL%s Display Formatting and Control 
Facility. The VIP 7200 line protocol handler "nonforms mode" 1s not 
supported by ATD. The equivalent functions can be ohtained by using 
the forms mode with a form defined as fully uneretected. 
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level 


The oriority level at which the communications supervisor orocesses 
requests for an input/outout operation to the station. The value 
for level is an integer from 7 through 6/* it may be same as the 
level specified for other communications stations, but it mist be a 
higher aumber than the communications interrupt level(s) specified 
in the COMM directive. The level specified for one or more 
communications stations may not also be used for noncommuntcattons 
devices or tasks. 


X%cnanne 1? 


You nay specify a single zero (0) to float this channel assignment 
Or a four-digit hexadecimal number (from X“040n% to X’FF8nN7), that 
specifies the channel number of the station and the {fnetrruot 
priority level (n) of the line. The channel number prAas the 
following formats 


3its 9 through 9 - The 10=—bit channel address of the send or 
receive channel on the lines. 


Bits 10 through 13 = Must be set to zero. 

Bits 14 and 15 - Soecifiles n, the priority level at which a 
communications line interruots the central 
processor. n may have a value of 0, I, 2, %r 3 
as specified in the COMM directive. See the 
deseription of the COM directive for further 
information, ‘ 

(modem) 


A number snecifying the type of data set. Possible values are as 
follows: 


O = Direct connect. 

1 = sell txx=tyne modem (103A, ete.). Both data-set-ready and 
carrier-detect signals are required for a ecsnnection: absence of 
these signals ts a disconnection. 


3 or jreater ~ \Jser-defined nodem type (see "MODEM Directive”, 
earlier in this section). ‘ 


The default value is modem type |. 
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OOZLA/ALLA/ASOUA 


ee eee 


(speed) 
The data rate in bits per second. 


For an asynchronous line with a communications~pac whose id is 
2108(14), use one of the following values for speeds . 


50 300 2400 
75 600 3600 
(default) 110 900 4800 
134 1200 7290 - 
150 !800 9690 


For an asynhrenous line with a communicationsepsc whose id is 
2100616), Sena’ or 24)18¢(146), use one of the following values for 
speed ? 


50 200 1890 
75 300 2000 
(default) 110 490 2400 
i34 1050 4809 
150 i200 9600 


In VTITY or V7200 directives, you have the option to defer selection 
Of tne line speed until the terminal cones on-line. You select this 
option by specifying HI or LO. 


“HIS 
Seecifies that all terminals associated with this line will be 
permitted to function only at soeeds from 1200 through 9500 
bits per second. 

“L0¢ 


Specifies that all terminals associated with this line will be 
oermitted to function only at speeds from [fIt0 through 1290 bits 
per second. 


For more information about the Line soeed selection capability, 


refer to the discussion under “Topics Related to CLM Directives" 
near the beginning of this section. 
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{device_type] 


Specifies the type of terminal used. The allowable types and the 
default for each directive are as follows? 


Directive Devices supported device_type 
V7200 VIP 7200, VIP 7205 7200 

VIP 7801, VIP 7802 780! 
VROSY PRY 1001, PRU 1003, PRU 1905, PRU 

THU !001, TwU 1003, TWU 1005 


VTITY An asynchronous terminal that TTY 
. {gs to be supported as 
teleprinter-compatible 


(del) 


In the TTY mode, a head~of-form sequence (pre-order control) 
consisting of three LF’s and the number of DEL characters speci fied 
by this argument its generated if the following conditions are met. 
(if the conditions are not met, no head-of-form sequence ts 
generated). 


- The first byte of the application’s buffer must be designated 
as a control bytes i.@2., bit 4 of the IORB’s device specific 
word (I_DVS) must be set to O at write time. 


« The control byte must specify that a head-of—form sequence is 
to be generated: f.¢e., Sit 3 of the control byte must be set 
to |i. 


« Device type PRU is not specified. If it is specified, a true 
head-of=-form is {ssued, 


In the fileid or TTY modes, an LF {tn an end-of-message sequence (post 
order control) is followed by the number of DEL characters specified 
by this control argument. 


The EVM sequence is controlled by the 8= and C-bits of the [ORB’s 
device specific word I_DVS, as specified by the application at write 
time. The TTY line protocol handler sends an EQM sequence according 
to the following Be and C-bit values, 


ILDVS Bits 
B Cc EQM Sequence 
0 0 CR 
0 I None 
; 
1 


0 CR,L-,DEL characters 
| LF,OEL characters 


6785 


NNZAIALAVAALASOUA | 


VROSY/VITY/V/20U 


At read time, the application can specify the same B= and Ce bit 
values in order to send an EQM sequence back to the terminal when 
the message is successfully received. 


Note that an LF character in a pre-order control specified by the 
T=CON word of an IORB is never followed by a DEL characters i.e., 
this control argument has no effect in this case. 


This argument allows you to select |! to 32 DEL characters. The 
default for each type of device is as follows: 


device type Number of DEL characters 
7200 ea a ge 
7801 ) ) 
PRU J 
TTY i 


[stop_bit] 


Specifies the number of stop bits that are to follow each character. 
A value of i or 2 can be enosen for each device. Default values are 
as follows: 


Number of Stop Bits 


8 Ce De ED Ge Co Ges 


J 
(for soseds greater 
than ii0 bits per 
second} : 


2 
(For se speed of 110 
bits per second or 
less) 


Coarity]} 


Specifies the type of parity (enter ODD or EVEN) te be used. The 
defauit is EVEN. 
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SECTION VII 
MOD 400/MES PROGRAM MATERIALS AND DISTRIBUTION MEDIA 


A listing of MOD 400/MFS program materials {s provided in Figures 
7-i through 7-19. Figure 7-1] lists the program materials made 
available with the MOD 400/MFS Executive. Figures 7-2 through 7-19 
list the program materials made available with the various 
separately=priced products that can Se used with the MOD 400/MFS 
Executive. Order numbers for these products are also provided. 


MOD 400/MFS software is available on the following media: 


Cartridge Disk 
Cartridge Module Disk 
Mass. Storage Unit 
Viskettes 


¢* ¢ @ @ 


MOD 400/MrS Executive software can be distriduted on 2a Min 

Cartridge disk (“ZSYS62), two cartridge disks (*ZSYSS5! and “=7SY$52), 
a single cartridge module disk (“ZSYS4i), or ona single mass 
storage unit (*ZSYS71). If an {installation orders any of the 
separately-oriced oroducts, appropriate modules are added to “ZSYS51 
and “ZSYS52, “ZSYS61, “ZSYS62, or “ZSYSTI, or they are orovided on 
separate diskettes. 


MOD 400/MFS Executive software is made available on uo to five 
diskettes (“ZSYSO0, “ZSYSOA, “ZSYSIA, “ZSYS!3). The software will he 
packaged to make most effective use of the distribution media. 
Software will be packaged us on to five diskettes if the user 
receives the software On single-sided diskettes. If the user 
submits diskettes with a larger capacity, then fewer diskettes are 
required. 


Users serforming system installation with CII HONEYWELL 
3ULL=-sunplied distribution media should note the following: 


« If the MOD 400/MFS Executive was distributed on a Mint 
Cartridge disk, cartridge disks, 4a cartridge module disk, or a 


mas3 storage unit, then all Executive modules will be present 
on the volume(s). 


- [f the MOD 400/MFPS Executive was distributed on multiple 
diskettes, then gach diskette will contain a subset of the 
total mumber of Executive nodules. The diskette labeled “ZSYSOO0 
must be used as the bootstrap volume at initial system startup. 
The user must be aware, however, that “ZSYS00 weill not contain 
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sufficient software to permit use of the full range of “oD 
400/MFS functionality. Onee the user attains the limited 
processing environment permitted with “ZSYSOO, then the user 
should examine the contents of the other diskettes and delete 
and transfer software modules as desired. The user can consult 
rigure 7=!] to identify Executive modules required for various 
40D 400/MeS functions. 


In Figures 7=-I through 7el%9, elements enclosed within boxes are file 
systen directories. Other elements are files.(l) Indentation 
signifies subordination = that is, all files described in 4 given 
directory are indented from the margin of the boxed directory name. 
In a few instances, one directory is shown t°% be subordinate to 
another directory’ sane hy {ndentation is used to signify this 
relationship. 


° 


SOFTWARE TO 3E PLACE) ON THe BOOTSTRAP VOLUME 


eertain modules must he present on the bootstras volume in order to 
achieve system startus. Otrer modules must be present on the 
Sootstran volume if certain tynes of processing are to be suoported. 
These reguired modules are described in the following diagrams. 


C1) 
Note that in some cases files are immediately subordinate to the 
volume root directory. 
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a 
Z3EXECUTIVES SAF system executive? required 
6 


Z3EXECUTIVEL LAF system executive’ required 
START_UP EC File used with CLM_USER:’ required 
GROUP SH.EC EC file to spawn sH task group 
GROUPSP.EC EC file to spawn $P task jroup 


SUPER.EC EC file required for a dual-purpose Operator 
terminal 


GROUP SD.EC EC fila to spawn $D task group 
DE3UG.WORK Nork file for sD DEBUG 
DESUGDB Lead task of $D DEBUG utility 


RECOVERY File recovery 


File used for SH task groups required if 
CLM_MDC or CLM_MCP used 


Error message Ili>rary 


mailbox aveue 
mailbox queue 


ZIMLCC LU 
ZGQ1S8.0 
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CCP_LMAC.INLA 


MGIRB.IN.C 
MGRRB.C 
WGCRB.C 
STARTLUP.EC File used with CLM_MDC or CLM_MCPs required 
Oonlu if either is oresent 
CL SAMPLE Sample CLM file: optional 
crest Commercial simulator 
Vole Configuration Load Wanagert required x 
CLMCMI CLM functions’ required yx =. 
CLACM2 CLM functions reauired . 
CLMCM3 CLM functions’: required 
CLMCM4 CLM functions! required 
Y Chaco CLM functions? required 
“ SLHDEV CLM functions: reouired | 
& CLMPLT CLM functions: required 
b CLYMMMS CLM functions’ reauired | 
& SLMLHO CLM functions’ required 
” SLYMAP CLM functions’ required x | 
“ CLASTI CLM tablest reauired 
| i/cLust2 CLM tables: required " 
i-CLMST3 cLM tablest required 
 SLYVAR CLM funetionss required 
8 SULA Makes all Executive overlays residents ootional 
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ROLLCO CLM code for rollout functions required only 
{f rollout capabtiity is configured 


C 

SIPSIM Single/Double Precision SIP Simulator 
c 

SIPSIM_SP Single Precision SIP Sinulator 


VLUCD CLM code for MMU functions? required only if 
MMU present 


e 
ZERRST Error statistics modules optional 
c 


CLM conmunications module 
ZIEACU Auto Call modules optional 


¢ 
Z3=SEL Speed select modules optional 
€ 
Y ZIsxec xX Communtcations supervisor 


ZQYLPH Communlcations HASP line orotocol handlers 
optional c 


PELZLIPATO X Communications asynchronous terminal line 
protocol handlers ootional c 


ZIPCRT Communications synchronous terninal line 
protocol nandlert optional c¢ 
e 
ZXPFR Power Resumotion racilitys optional 


Cc 

ZIP TTY Communtcations TTY Line protocol handler 
c 

ZaPV iP Communications VIP Line orotocol handler 


Zac! communications ReI Line protocol handler’ 
Optional c 
fe 


; ¢ 
Z.2TDOUM Required for a communtcations configuration 
¢ 


ZITRAX Internal Diagnostic Trace Capability 
c 
ZXVEFM Defective Memory Trao Handler 
¢ 
ZQECP I Auto call channel control programs optional 


c 
ZQPATC ATD channel control orograms optional 


‘_- - Figure 7! (Cont). 40D 400 Executive Program Materials ._.....__.. 
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Z2e°cC STD channel control programs ostional 


ZIPTCS TTY channel control orogram; Bpelonel. 

ZIPPVE 

ZOPACT ACTD asynchronous LPH 

ZOPACC ACID channel control program 

Z2°PRT Printer management 

Z3e°BDG Badge Nanagement 

ZIPS5UR common subroutines to ZOPPRT and ZOPBDG 

ZIXVIP | 

ZIXPVE 

ZIXBSC 

ZOXPBS 

ZQXATD 

Zax TTY 

ZIXCRT 

ZO XXEC 

CLALMC P File of CLM directives usea during stage i 
system startun with WLOr/DLCP-connected 
operator terminals required if your installation 
has an MLCP/DLCP=-connected operator terminal. 

CLM_MOC File of CLM directives used during stage | | 


system startuo with “DC-connected operator 
terminals required if your installation has | 
an MDC-connected Operator terminal. ! 


Ee Execution command used for =C files: reauired 
if any START_UP.EC file used 


sd Change system directory opnerator command; 
required 


Figure 7-1 (Cont). MOD 400 Executive Program Materials 
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ABORT_BATCH 
ABORT_GROUP 


CKPTrILs 
CMR 

CP 

CPA 

CPAS 


DP 
DPEVIT 
DPN 
OT 
EBR 

d 
EC 
EGR 
EQJAL 
ETR 
FQ 
LISTENER 


NEAW_LPROC 
NOW 
OPeR 


PR_HJLD 


STAR T_ELOG 
STAR T_MAIL | 
STG 
STOP_LELIG 
STS 


_ Time 


UNLD 
UPD_<o UM 
USER 

LT 

Lwi) 

LX 
M4_SYSDEF 
MEA 


RECOVER 
REMOVE 
RESTORE 


Pp 
VALIUCKPT 
WH 


WS 
DMBX 


Figure 7=! (Cont). MOD 400 Executive Program Materials 


iecabss 
VOAM FORM I MT9G I 
RDYT MT7G1 
ZTVM 


ZTV1I00 


a 
Present Only On SAF medium 


5 
Present only On LAF medium 


Cc 
If the system is to include this capability, this system software 
must be present on the bootstrap volume before configuration. 


NOTE! Software modules listed as being optional may be judiciously 
deleted if the user does not wish to configure a particular 
capability? otherwise, the aporooriate software modules must 
be included with the Executive software if the user wishes to 
configure an optional capability. 


df 
Required for Stage ! and Stage 2 system startuno. 


Figure 7=! (Cont). MOD 400/4FS Executive Program Materials 
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ZGQISB8.0 
ZIMLCC.0 


macro routines 


macro routines 


Figure 7-2. Assembler/Macro Preprocessor Program Materfals (SHL937) 


FORTRAN 


ob ject modules 


Figure 7-3, FORTRAN Program Materials (SHL936) 


RPG 


AUTO 


AJTUR 


Figure 7-4, RPG Program Materials (SHL924A) 
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SORT 


SoRTC 
MERGE 


Pigure 7<5. SQRT/MERGE Program Materials (SHF9I0) 
ae) 
1 
ZQrP85SC 
J 
ZQxnLPH 
ZOPPBS 


. These program materials must be transferred to the bootstrao volume 
before confiquration. 


Figure 7-4. rile Transmission (Non-HONEYWELL Host) (SHC953) 


Figure 7-7. Intermediate COBOL Program Matertals (SHL925) 


(ZoR7] 


Der SAMPLE. S$ 


od fect modules 


Figure 7-8. DEr=[ Program Materials (SHC917) 
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NN 


SYSLIB2 
RBT 


Figure 7-9. RBF/66 Program Matertals (SHC9I5) 


SID SYSLIB2 


ZOPPVE TRAN 
i 


ZORCI 


| 
These program materials must be transferred to the bootstrap volume 
before configuration. 


Figure 7-10, File Transmission (CII HONEYWELL BULL Host) Program 
Materials (SHC951) 


W352 780 
W353 780 


Figure 7-i2,. 2780/3780 Norkstation Facility Program Matertals 
( SHC958) 


711 


stu | 


J 


ZaPPas 
SYSLis2 


Leg2vi 
Zr32in 


ZCUBIF.O 


t 
. These program materials must be transferred to the bootstrap volume 
before configuration. 


. 


Figure 7-13. Programmable racility/3271 Program Matertals (SHC988) 


FORTRANA 


runtime routines 


Figure 7-5. Advanced FORTRAN Program Materials (SHL944) 


Tq=1t2 


LNKSPRG.EC 


a 


runtime routines 


runtime routines 


Figure 7-14. BASIC Program Materials (SHL942) Interpreter, (SHL943) 
[nterpreter/Comptiler, (SHL932) runtimes 


SYSLI32 
Dee 
DESCMPL 


Jer-[I system forms 


COSILA 


object modules 


Figure 7-19. Advanced COBOL Program Materials (SHL945) 
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BCF FORMS 


ZQDMN T 
ZQDIPR 
ZQDSTA 
ZQDBYE 
ZOQOSTR 
ZQOSND 


User-written TBUs 


ZQDATD : BCFGEN.EC 
ZQUDMP ; User-written BCF generation 
ZO99UM 
ZQDFWK 

ZADINI 

ZQD LOC 

ZQUISN 

ZOVI0) 

ZQD 102 

Z2IJ585 
Z2DLST 
ZQDMIS 

Z2200IM 

ZOQUPAT 

ZQDPRM 

ZADPVE 

ZODRES 

ZQDS<c 

Z20STD 

Z0iSUB 

ZOUTCL 

ZQOTSK 

ZOITSV 

ZQOTTY 

ZQ0TUI 

ZO TO2 

ZQ0T72 
ZQ0DOVL 

ZQDUSN 

ZQUUTR 


Figure 7-19, Boe Program Materials (SHC987) 
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SS 


ZQD8YE 
ZQU3CF 
290086 
ZODMNT 
ZQOSND 
ZQUSTA 


ZQDATD 
ZQDOMP 
ZQNDUM 
ZQDEAK 
ZQJINI 
Zav1v0C 
ZQUISN 
ZO T04 
ZQUI02 
Z20J35 
ZQDULST 
ZQUMIS 
ZIQVOIM 
ZQvrAl 
ZQUPRM 
ZQDPVE 
ZQURES 
ZQUSCH 
ZQDSTO 
ZOQUSUJB 
ZO) TCL 
ZQD TSK 
ZQUTSV 
ZQWTTY 
ZQD TOI 
ZQITO? 
ZQDT7 2 
ZQDOVL 
ZQUUSN 
ZQU UTR 
ZQDATL 
ZQICNX 
ZQU 3YX 
- ZQDOFF 
ZQUSTY 
ZQDSPU 
ZIvVTPYU 


Figure 7-20. DT= Program Materials (SHC957) 
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INCLUDE 
UOTPMAC IN 


COBTBU.EC 
TBUI 
TBUN 


Figure 7=26 (Cont)."OTF Program Materials (SHC957) 
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ZQDATD 

ZQOUMP 

Z2 UM 

ZIWeWK 

ZQJINI 

ZQVIOC 

ZQU ISN 

ZQ9T01 

ZIV 02 

2Q0IB5 

ZOQOLST 

ZaD 41S 

ZQDOQIM 

ZQ IP AT 

ZQI PRM 

ZQUPVE 

ZODRES 

ZQUSC 

Z33TO 

Z205ua 

ZQQTCL =s 
ZQUTSK DRARGEN.EC 
ZaoTey DAR. 
ZaTO! 
ZQVRO2] 

ZQDT72 COBTBY.EC 
ZQDIVL TBU : 
ZQIUSN 

ZQDUTR 

ZQDATL 

ZIICNX 

ZQISY X 

ZQDDFF 

SUIS TY 

ZIISP J 

ZAITEU 

ZQ3F IL 

ZWUEB 


rigure 7-21. DTF With Restart/Recovery Program Materials (SHC936) 
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TRANS 
FTIr64 
Rbr 54 
UNSPOL 


TMMLPH 


SYSLI 32 
RBS 


ZNVDAM 
ZNV 72F 
ZNV 77F 


SYSLI 32] 
VEORMS 


ZNVUPR 
ZNVCRM 


Figure 7-24. Program Matertals For Display Formatting and Control 
(SHC961) 
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SECTION VIII 
TECHNICAL NOTES 


This section describes a number of miscellaneous tonics, most of 
which pertain only to certain installation sites. Before attempting 
any use of the system, you should ascertain which of these topics 
apply to your installation and oroceed accordingly. The following 
toptes are deseribeds 


__.. « CSD (Change System Directory) operator comma nd s in START_ UP. EC 


file for system task group 


« Transferring the contents of “ZSYS5!I or “ZSYS6! to the fixed 
platter of a twoeplatter drive 


- Procedure for transferring software modules 


CSD OPSRATOR COMMANDS IN START_UP.EC FILE OR SYSTEM TASK GROUP 


tf a STARTLUP.EC file is used for the system task groupo during a 
Stage 3 system startup (1), Lt must be immediately subordinate to 
the root directory of the Snotstrao volume. This START_UP.EC file 
shoyvld contain one or more CSD (Change System Directory) operator 
comnands to reassign the system Libraries ~LI81 and -LIB2 away from 
their defaults (the default asstgnment fo both -LIBI and -LIB82 ts 
SYSLI3! on the bootstrap volume), 


[ff the system is to be bootstrapped from a non=-diskette volume, the 
STAST_UP.EC file for the system task jgroup should contain the 
following two CSD operator commands (in addition to any other 
appropriate Operator commands) t 

“SD -LI8I pathname_to_user=1 ibrary 


eSD =LIB2 >SYSLIB2 


(1) 
The stages of sysCem startup are described {n Section [II. 
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- . Svystem search rules and the system commandS ~ UUTUTD OT 


These operator commands will appropriately specialize the systems 
search rules for this environment. When the system’s loader seeks a 
bound unit to be loaded, it will first search the user’s working 
directory (default), then (if necessary) the user_library (-LIB1), 
then (if necessary) SYSLIB2 on the bootstrap volume (-LIB2). 


If the system is to be bootstranped from diskette (“ZSYS00), the 
START_UP.EC file for the system task group should contain the 
following CSD operator commands 


CSD =-L1B)] “ZSYSOt>SYSLIBI 


This operator command will appropriately specialize the systems 
search rules for a diskette environment. When the system’s loader 
seeks a bound unit to be loaded, it will first search the user/’s 
workiny directory (default), then (1{f necessary) “ZSYSOI>SYSLIB! 
(L131). Typically, tn a diskette environment, the ooerator uses 
dynamic CSD operator commands to assign -LIB2 to the pathname that 
will be searched (1f necessary) following “ZSYSOI>SYSLI81. 


TRANSFERRING CONTENTS OF SZSYSS 1 OR *ZSYS6! TO FIXED PLATIER 


[If your system is cartridge-disk-~-based or 
cartridge-module-disk=-based, you may wish to cosy the contents of 
your system volume to the fixed platter of a two-platter drive. The 
orijzinal HONEYWELL=supplied system volume may then be dismounted and 
savei as backup. The following procedure is recommended.(!) 


1. Mount system volume “ZSYS5i on RCDOO, or mount system volume 
“ZSYS61 on RCMOO. 


2. Perform a stage 2 system startup, bootstrapping the system 
from RCDOO or RCMOO, 


(1) 
Assume that this action involves a stage 2 system startupt the 
CLM_LUSER file {s assumed to include the following DEVICE 
directives: 
ror cartridge disk-based systems? 
DEVICE RCD00,1,4,X71400% (removable cartridge disk) 
DEVICE FCDO00,3.6,X°1400"% (fixed cartridge disk) 
For cartridge module disk-based systems? 
DEVICE RCDOO,!1,6,X%1400"% (removable cartridge module disk) 


DEVICE FCM00,3,4,X71400"% (fixe cartridge module disk) 
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3. 


3. 


9. 


Use the following CV (Create Volume) command to initialize the 
fixed olatter of the cartridge disk: 


CV¥ ftFCD00 -FT ZUSRS I 
(ZUS251 is merely an axamole of a user-supplied volume_id). 
If your system is cartridge module disk-based, use the 
followin3 CV (Create Volume) command to initialize the fixed 
platter of the cartridge module disk? 

CV !FCMOQO -FT ZUSR41 


(ZUSR46! is merely an example of a user=-sucolied volume_id). 


Use the following CP (copy) command to cooy the entire 
contents (except volume_td) of “ZSYS5! to “ZUSRSI 


CP !RCD(KeZSYSSI1 frCDOO =—VOL 
If your system ts cartridge module disk-hased, use the 
following copy (CP) command to copy the entire contents 
(except volume_id) of “ZSYS61 to “ZUSR61+ a ee 
CP !RCMOO>ZSYS61 !FCMTX) -VUL 
After the copy is completed, press STP. 
Performs another stage 2 system startup, this time 
hootstracoing the system from FCDOO or FCMO0O, as aoproortiate, 
(Enter 140! into the Rleregister after the TRAFFIC Liaht turns 
off following Stop. Cheak, Load, Execute). 


Nhen system startup Ls complete, dismount *ZSYS51 from R&CdN0 
or “ZSYS6!1 from RCM0OO. 


Mount a new cartridge disk on RCD‘X) or RCMOO, as aporoortate. 


For cartridge disk-based systems, tise the eon CV command 
to initialize the new cartridge disk: 


CV fRCDOO -FT USRVOL 


For cartridge module disk-based systems, use the following CV 
command to initialize the new cartridge module disk. 


CV IRCA(K) -FT USRVOL 


(USRVOL is merely an example of a user-supplied volume_id). 
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10. Use the following CV command to create a bootstrap record on 
“USRVOL’ (The bootstrap record must be on the removable 
volume, even through the system is to be bootstranved from the 
fixed platter). 


CV SRCODOOPUSRVOL =BONOT [xX714017 7] 


For cartridge module disk-based system, use the following 
command % 


CV PROMOOSUSRVOL ~BOOT (X714014 ¥1 


NOTE* After a bootstrap record on a removable cartridge disk 
or cartridge module disk has been used to bootstrap the 
system executive from the fixed cartridge disk or 
cartridge module disk, the volume_id of the fixed 
cartridge disk or cartridge module disk is assumed to be 
to the left of an absolute pathname that begins with a 
greater=than sign (>). 


SYSTEM SEARCH RULES AND THE SYSTEM COMMANDOS 


The system builder should {tnsure that system commands (or at least 
that subset of system commands most frequently used) are accessible 
ta the system’s loader. 


Nhen the system’s loader seeks a bound unit to be loaded, it 
oroceeds as follows?® 


[f the user supolies a full sathname (one heginning with a 
circumflex and the volume id), then the system loader will search 
for that specific element, 


If the user supolies a simple (single=element) pathname, then the 
system loader will search for the element according to a set of 
search rules, 


The search rules soecify the order in which the loader is to search 
one or more directories for the element in the simple pathname. The 
default search rules for MOD 400 are (1) first search the user’s 
workin) directory, (2) next search the system directory SYSLIBI on 
the root volume and (3) finally search the system directory SYSLIB2 
on tne root volume. 


(1) 
If X%1401% is not specified, 1401 must be entered into the 
Riegregister (as shown in steo 4) whenever the system is 
hootstrapped from the fixed platters however, other bootstrap 
Options (see Table 3-2) can be used more flexibly if the bootstrap 
channel number (plus options) is entered into the Rl-register each 
time the system is bootstraoped. 
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The operator can use the CSD command te change the system search 
rules. In normal operations the operator should use the CSD command 
to specify that one of the directories to be searched is the system 
diirectoryy containing the system commands. The user should note that 
those system command not accessible to the loader under the search 
rules must be specified with a full pathname. (ror examole, the CP 
command would require the user to specify “volume_id>SYSLIB!i>CP), 


PROCZDURE FOR TRANSFEQRING SOFTWARE 


A procedure for transferring modules is described below. 


Prior to performing the orocedure, the user should, of course, 
determine the modules to be transferred and the unneeded elements on 
the volume to which new software is to be added. Section VII 
contains a description of the contents of all disks. 


1, Aount the volume containing the modules to be transferred on 
an available drive. 


2. Use a list names command (LS) to ascertain the size-of the —---— 
modules to be transferred. 


3. Mount the volume to which the modules are to be transferred. 
4. Jse an LS conmand to ascertain the size of unneeded elements. 
5. Release unneeded elements. 


6. Mount a new diskette on an available drive. Use a create 
volume command (CV) to initialize this diskette. (Use 4 
temporary, unique volume identifier). 


7. Use a create directory command (CD to create appropriate 
directories on the new diskette. 


a. Use a copy command (CP) to copy the remai.ing contents of the 
volume mentioned in step 3 to the new volume. 


9. Ensure that the volume referenced in step | above is mounted 
and use a cooy command to copy the approorlate modules to the 
new volume.(1) ' 


0. Use a CY command to rename the new volume, (ff the new name 
duplicates the name of a currently-mounted volume, the system 
will tssue a dismount message, directing you to dismount the 
newly-renamed volume). 

Ct) ; 

When adding elements to the hootstraso volume, the system builder 
should remember that if a rollout capability is to he established, 
sufficient space must be available on the volume for the ROLLOUT 


file created during system configuration; this rollout file must be 
larze enough to accomnodate the batch inemory pool. 
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APPENDIX A 
STARTUP HALTS 


Startup halts may be classified in three categories: 
« dalts related to hootstrap operation. 
« Srror halts related to Configuration Load Manager. 
e error halts related to other aspects of system tnitialization. 


A nalt related to the dootstrap operation may have heen 
intentionally requested, or it may reflect an error condition. A 
bhootstrao nalt is tntentLonally requested by setting ON bit 13 of 
the I4~bit (four hexadecimal dizgits) bootstrap channel number (see 
Table 3—2). [n the event of this type of bootstrap halt, the 
following register contents are significant: 


« Rieregister contains bootstrap channel number. 


« AQ~register contains address mode flag? 0 indicates SAF; 
| indicates LAF. 


. rse-register identifies the bootstrap device typet 


2 {tadicates cartridge disk, cartridge module disk, or mass 
storage unitt 1 indicates diskette. 


srror halts during hootstrap result in a I6nn value in the 
Rierejgister. See the System Messages manual for a description of 
the ISI1t, 1612, and I41T4 error STts 


NOTE? [f a hootstrap halt occurs with a i6!4 error condition, there 
is a sossibility that the D7 register will contain no error 
status. To obtain status in such circumstances, select D7 
prior to retrying the operation and observ? D7 during 
Hootstrap processing. 


Error nalts related to the Configuration Load Manager result in a 
i3na value in the @leregister, usually additional information 
relative to the halt is available in, or through, other registers. 
See the System Messages manual. Note that if an operator terminal is 
connected to an 40C (Cand if its DEVICE dtrective has already heen 
read), a configuration Load Manager error condition oroduces an 
2rror nessaje 2t the ooserator terminals in this case, 2 halt occurs 
(in addition to the message) only under certain error conditions. 
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Configuration Load Manager error messages are described in the 
Systen Messages manual, 


_/ 
=zrror halts related to other assects of system initialization result 

in 3 29nn value in the Rl-registers in some cases additional 
information relative to the halt is available in, or through, other 
registers. See the System Messages manual. 
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APPENDIX 8 
SYSTEM OVERLAYS 


Tabla Be! srovides a list of all system overlays that can be made 
permanently resident in the system area of memory. Each overlay to 
be nade permanently resident must be named in 4 RESOLA directive 
(describad in Section V). “Multiple system overlays can be named in 
a Single RESULA directive. 


Besid2 each overlay name in Table B=! {fs the approximate size (in 
Jecinal words) the overlay reoauires in nemory if it is made 
sernanently restde.t. In certain cases, footnotes indicate qrouns 


of overlays that should ali be made sernanently resident if optimum 
speed is destred for that functlon. 


Table Bel. System Overlays 


Executive 
Services 


OI OMS QIM dispatcher (all LRN O orders) 
OLA AO QIM Laput processor 


OLOIMI QIM command processor, output completion, and 
break handler 


OLOL42 VIM output control 
OLO UA QIM diagnostics 


OI1OIM4 WIM abort group request purge and OIM monitor 
call handler 


OMSTAT SST49 (status memory pool) macro handler, and 
get specific memory block 


OO8IND Loader ~ Processing of relocation items 
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Table Be! (Cont), System Overlays 


Overlay Size 
Name (in words) Function 


OOCRIT Loader - Create OAT and release, wait and 
recall overlay MCL handler 


OOMSCd) Loader = Processing of SLIC load units, 
unilsading ef bound units 


OOPACK Loader =- Resolution of symbols defined by 
LDBUYs and of root entry names 


OOR OV! Loader = Load of bound unit (ohase 1) 
OOR 002 Loader - Load of Dound unit (ohase 2) 
QUE4L2 Error message library processing 

QUcRSI Error reoorted (ohase 1) 

QUERS2 Error reported (phase 2) 

QUERS3 Error reoorted: trap errors only 

OXAL SP Break task activation/suspension 

OXAVAI Automatic volume recagnition 

OXIXFY Bound=-unit transfer MCLs 

OXC_IX Convert from/to external/internal date/time 
OXCTS<K Create and spawn task 

OXCDRV Create driver (initialization use only) 
OXCGRP Create and spawn group 


OXCKPT Checkpoint, determination of 
checxsointability and phase |! of checkpoint 


OXCKP | Checkooint —- shase 2 
OXCK P2 Checkpoint = phase 3 
OXCKPA Checkpoint file assignment =- part |! 


OXCK PA? Checkpoint file assignment ~ part 2, and 
checkvotnt file disassignment 
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R Table df (Cont). System Overlays 


Nee 
OxDr RT Place deferred spawn task request 
Spawn deferred task (after defer {nterval) 
OXILSP Delete/abort grouod (and abort group request) 
OXDTSK Task Deletion (created or spawned tasks) 
Request task deletion (created tasks) 
OXELUG Error logging MCLs 
OXSSAN0 External switch handler 
OXGACT Group activate (rollout ohase 2) 
OXS35P Group suspend (phase 1) 
OX 5RQS Start group request (phase |) 
OXGRS2 Group request startuo (shase 2) 
OXSRIT Terminate group request (phase 1) 
OXIRT2 Terminate group request (phase 2) 
OX SRT3 Sroud request termination (phase 3) 
OX 49 I Message factlity: MCL dispatcher 
OXMFI2 Message facility task request dispatchers 
Nic Call MF YCLs 
OXF I3 Message facility activate mailbox: open 
mailbox file (accegt and recef{ve - disk 
queuing) 
OX Mr O04 Message facility: accept UCLs 
OXMr 05 Message facility? accept MCLs and read record 
from message facility file (acceot and 
receive — disk au¢uing) 
OX MF 06 Message facility: initfate MCLs 
saywecias’ ton ee Mes OFZ < Message facility: send MCLs. sisi 
NS 
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Table Be! (Cont). System Overlays 


Over lay Size 
Name (in words) Fune tion 
— ee eS 


OXMe 08 Message facility: send MCLs (disk 
queuing/backup)% terminate message MCLs 
(send) 


OX MF OS Message facility? receive MCLs 
OXMP IO Message facilityt cancel enclosure level 


MCLs, delete quarantine unit (receive MCLs = 
disk queuing/backup) 


OXME PI Message facility: terminate message MCLs 
(receive) 
OXMP 12 Message facility: close mailbox (all 


terminate message MCLs = disks 
queulng/backuo’s initiate MCLs ~ disk queuing; 
message count MCLs) terminate message “CLs 
(waiting acceptor) 


OXPCBY Process command line? activate functions 

OXPCL 1 Process command linet (phase !) 

OXPCL2 : Process command line: (phase 2) 

OXPCL3 : Process command line? break interrupt handler 

OXRQSGP Request and spawn group (phase 1) 

OXRIG2Z Request and soawn group (phase 2) 

OXRIG3 Request and szawn yroup (when mailbox queued 
request) 

OXRST Restart phase | 

OXRSTO Restart ohase 2 

OXRSTI Restart phase 3 

OXRST2 | Restart ohase 4 

OXRST3 Restart phase 5 

OXRSTS Restart = terminal substitution 

OXRSTF Restart phase 6 (last) 


OXRSTA Restart = bound units preservation 


<< —— ——_ 
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Table d=! (Cont). System Overlays 


Overlay Size 
Nane (in words) Fune tion 


Restart ~- trap processing and suspension 
activation during restart 


Restart - error processing 
OXS Tul Standard inout/output (new user, command_in) 
OXSTv2 Standard inout/outout (new user, user_out) 
QXSLO3 Standard {nout/output Cinput Line expansion) 


OXsTu4 Standard inout/outout (system error_out 
“andler) 


OXS¥CL Process semaphore MCLs 
OXTRI7 Defective memory trao handler 


OX TROD Connect user trao nandler (enable, disable 
user traos) 


OXTRR Terminal request handler 

OX vPed Identification/information macros 
OXUPF | Identification/information macros 
OXACS I Load Writable control Store 
OXATLY Wait list processing 


“-f{le Yanagment 


OYASS Associate/disassociate file = MCL 


OYCRE Create file — MCL 

QYC IR Create record descriptors = MCL 

OYOLSe Delete file = MCL 

OYLKE Linx file = MCL 

OY 4de Modify disk file attribute/name ~ MCL 
OY Ube Unlink file ~ MCL 


oe eee ee 
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Table Bel (Cont). System Overlays 


Overlay Size 
_Name (in words) | Function 


OZALX Allocate disk space = record extent in 
directory 

OZALX2 Allscate disk space = GET space for one 
extent 

OZR! Create file = primary/alternate index 
parameter 

OZER 3 Create file - calc/ids-2 parameter 

OZC AF 4 Create file = permanent file 

OZCRF5S Create file - temworrary file and subroutines 

OZC RR] Build record descriptor 

OQZLKOR Linx and rewrite directory record 

OZULDR Unlink directory record 

OYGIIV Set device information — MCL 

OYSTF Get file information = McL 

OYSTr Get file = MCL 

OYR Ar Remove file = MCL 

OZGTF 2 vet file ~save/restore interface 

OZGTr 3 Get file = tame parameter processing 

IZ IV Get file - create Device Descriotor Block 
(DDB) 

OZCr 38 5 vet file - create File Descriptor Block (FDB) 

OZvFc3 Get file = get File Control Block (FCB) 

OZSTRr Get file —- get related files 

DYORY Open file - MCL} 

OZ OPrD Qpen file - device files 

OZ0P Fr Open file = fixed relative file 
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Table Beil (Cont). System Overlays = 


(verlay Size 
Na.ne (in words) Function 


OZ OPFU Open file =~ sequenttal/relative/alternate 
indexes 

OYCLS Close file - MCL! 

OZCLED Close file = device files 

OZGRePT Grous termination 

OYACL Set/delete Access Control (ACL) = MCL 

QZACL2 Set/delete Access Control (ACL) ~ set ACL 

OYAVR Automatic Volume Recognizer (AVR) = MCL 

OYCMR Cancel Mount Request (CMR) = MCL 

OYIT Initialize Tape (IT) = MCL 

OYSAP Swap volume = MCL 

QZAVR2 AVR = device file other than tape 

QZAVR3 ; AVR - initialize disk Volume Descriptor Block 
(VDB) 

OZVMT Volume mount = request disk volume mount 

OZVMT2 Volume mount = request device/tape volume 
mount 

QZVMT3 Volume mount =- search for free tape 

OYCAD Change working directory = MCL 

OYXPA Expand file pathname - MCL 

OYSTTY Set TITY = MCL 

OYNTFL Watt file - MCL 

OZ SME 1/0 error handler = common to all files 

OZ SME L-- I/Q error handler - disk files _ Beet te 

OZ SME2 I/) error handler ~ message handler 
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Table B=t (Cont). System Overlays 


Over lay Size 
Nate (in words) 


Function 


OZ SMT 13] Storage management positioning function for 


tape 


OY BMCR Buffer pool = create/delete (MCL)! 

OY 38MGl Buffer pool = statistics (MCL) 

OY BMDL, Buffer poll =< Delete adjust! 

OZBM2 Buffer poo] = flush buffers and disassociate 
buffers 

Jata Nanagement 

OYOMR2 Fixad relative = MCL 
(read/write/rewrite/delete record) 

OYDRM3 UPAS relative = CL ‘ 
(read/write/rewrite/delete record) 

OZDMR UFAS relative ~ positioning 

OYDMSI String =~ MCL (read/write/rewrite record) 

OZDMS2 UFAS sequential - MCL (rewrite/delete record) 

OZACCB UFAS indexed/random = allocate CCB (Currency 
Control) 

OZUCCB UPAS indexed/random - igdate CCB (Currency 
Control)’ 

OZUSuUB UFAS indexed/random - common subroutines 

QYUOMT 1 Primary indexed ~ MCL (read/rewrite record)?* 

OYDM12 Primary indexed ~ MCL (write record in load 
mode ) 3 

OYUP II Primary tndexed - MCL (insert/delete record)® 

OZ TEXT Primary indexed ~ initialize for extend mode 

OZ LPF Primary indexed ~ open and close 

OZIPSN Primary indexed ~ positioning 


OYDML Cale - MCL (read/write/rewrite/delete record)‘ 


Table Bei (Cont). System Overlays 


Over lay Size 
Name pen woes words) Function 


QZC=ER Cale - error processing 


OZCINV Cale = inventory processing‘ 
OZCKEY Cale = hash/compare key ° 

OZCLNK Cale = Link/unlink cale record ° 
OZCOPF Cale = open 

OZCP SN Cale = locate/position record* 
OZCSUB Cale ~ subroutines ‘ 

OZDMAC Calc record modification 


OYDMX} Alternate index = MCL 
(read/write/rawrite/delete record ° 


(ZDUX Alternate index - update alternate indexes‘ 
OZXENT Alternate index ~- add/delete index entries ° 
OZXER Alternate index ~ error processing 

OZXLVI Alternate index = create index levels 
OZXPSN Alternate index = positioning function 
OZXSPL Alternate index ~ solit CI ° 

OZXSUB Alternate index = subroutines 


OYDMX2 Altarnate tndex = MCL 
(read/write/rewrite/delete entry) 


OYDAT Tape - MCL (read/write record) § 

OZDMT Tape - spanned record (read and write) 
OZTCLFE Tape ~ close 

OZ Te 3C Tape ~ EBCDIC and ASCII conversion 3 
OZ TE XD Tape = expiration date checking 


OZ TOP Tape - Open (common) 


Table B=] (Cont). System Overlays 


Over Lay Size 
Nane (in words) Function 


AZ TOP 2 512 Tape ~- labeled tape 

OZ Tive3 316 Tape = unlabeled tape 

OZ TOPS 49] ' Tape ~ process tape labels 

QZ TP SN 279 Tape ~ sositioning 

OZTSUB >. a8 ' Tape -subroutines, ASCII and hinary 

conversion f : 

OZTUTL 380 Tape = subroutines 
Checkooint, Restart. Record Lock, and Recovery Services : j~—~ 
OYCKPT 293 Checkpoint = WCL 

OZCKER 427 Checknoint ~ error reporting 

OZCKPT 479 Checkpoint — internal check ooint 

OYRSRT 438 Restart = MCL 

OY UREC . 293 Unlock record = MCL 

OZBEF 372 Before image - data management interface " 

OZS 1 GF 255 Before image ~- reservation 

OZBIIR 4i7 Before image - initialization 

OZBIOR 296 Before image ~ offline recovery . 
OZ3I1WR 275 Before image = write before image‘ 

OZCLPT 488 Clean point = MCL” 


OZR OLB 413 Roll back 


a 
This overlay should be made permanently resident if ootimum speed 
is desired in processing UFAS indexed files. 


b 
This overlay should be made permanently resident if optimum so eed 
is desired in processing UFAS relative files. 


€ 
This overlay should be made permanently resident if optimum speed 
1s desired in processing UFAS random files. 


d 

This overlay should be made permanently resident if optimum sn.eed 
is desired in processing indexed and random files, and alternate 
indices. 


ts desired in processing files with alternate indices. 


f 
. This overlay should be made permanently resident {f optimum speed 
ts desired in processing UFAS tape files. 


g 
This overlay should be made permanently resident {if optimum soeed 


1 
8 
This overlay should be made permanently resident tf optimum speed 
1s desired {n processing SBCDIC tape functions. 


h 
This overlay should be made permanently resident {f optimum speed 
ts destred in processing using record locking/recorvery. 


i 
This overlay should be made permanently resident {f optimum speed 
is desired in processing file management functions. 


j 
This overlay. should be made permanently resident if optimum speed 
is desired in processing using buffer o701 mangement. 


ee ee 
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APPENDIX C 
EQUIPMENT REQUIREMENTS 


> 


This asoendix contains minimum system guidelines and a list of 
supported equipment. 


MINIMUM SYSTEM SULDELINES 


Minimum system guidelines are offered as aids to system builders who 
must determine the resources required to oerform meaningful 
sracessing at the installation. Minimum system guidelines provide 
base configurations from which the system bullder can calculate what 
additional memory and peripheral devices (1f any) are necessary for 
efficient am effective operations. These guideiines will remain in 
effect until the next major release of MOD 400, 


Miniaum System for Program Development 


Progran development activity in a single-user environment can be 
accomolished with 44K words of memory (SAF or LAF) and a com liment 
of paripheral devices Limittad to the following! sone operator 
terninal, One printer, and up to four cartridge disks, cartridge 
nodule disks or mass storage units. 


In such an environment, the user can obtain an online memory cool of 
38K words (remaining memory would be reauired to accommodate the 
resident executive and a 6K~-word system memory pool). Additionally, 
this ninimum system would allow the user to provide for the 
following exhaustible resources? two system overlay areas, 17 traps 
save areas, and 30 {intermediate request blocks. 


Siniaum System for Online Arplications (Execute=Only) SAF Mode 


A configuration with 48K words of memory (SAF mode) and a comoliment 
Of peripheral devices limited to those deseribed below will permit 
the axecution of a wide variety of user applications [fn a 
single-user environment. (1) 


(1) 


The 2730/2780 Workstation facility can be used in an environment as 
described above with 32K words of memory. 
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« Two disks ()} 


» Qne printer 


oe teleprinter=compatible terminal cannected to an MLCP or 
Lcp ; 


« A PVE link 


In such an environment, the user can obtain an online memory pool of 
{3K words (remaining memory would be required for the resident 
executive and a 6K word system memory pool). Additionally, this 
minimum system would allow the user to provide for the following: 
the commercial simulator, two system overlay areas, !7 trap save 
areas, and 30 intermediate request blocks. 


Minimum System for ONline Applications (Execute-Only) LAF Mode 


A configuration with 64K words of memory and a compliment of 
peripheral devices limited to those deseribed below will permit the 
execution of a weide variety of user apolications ina single-user 
environment.(1) 


e Two disk (2) 


« JNe printer 


e une VIP7200/05 or VIP780!1/02 terminal connected to an MLCP or 
ILCP 


« A PVE link 


In such an environment, the user can obtain an online memory pool of 
16K words (remaining memory would be required for the resident 
executive and s 6K word system memory pool). Additionally, this 
tinimum system would allow the user to provide for the intermediate 
request blocks and the Display Formatting and Control Facility 
software, 


Ct) 
The 2780/2780 Workstation Facility can be used in an environment as 


described above with 32K words of memory. 
(2) 


In an all-diskette system, it 1s recommended for ease-of-use that 
four diskettes be selected. 
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SUPPORTED HARDWARE 


Table CC] 


when operating on the Model 23 central processor. 
Table C=2 lists the Level 6 equipment and options supported by 
MOO 430 on other central processor models.(1) 


Central 


Processor 


Console 
Adapters 


CPS9 35 | 
CPS9 352 
CPS9 353 
CPS9354 
CPS9 356 
CPS9357 
CPS9 358 
CPS9359 
CPS9370 
CPS937! 
CPS9372 
CPS9 373 
CPS9374 
CPS9375 


KCM9 30 1 
KCM9 302 


Table C-1. Supported Hardware - Model 23 


23 Minimount, 32K, 
now=disk 

23 Minimount, 32K, 
no=disk 

23 Minimount, 44X,- 
now~disk 

23 Minimount, 454K, 
nowdisk 

23 Minimount, 32K, 
no=disk 

23 Minimount, 32K, 
now-disk 

23 Minimount, 64K, 
no-disk 

23 Minimount, 64K, 
no-disk 

23 Minimount, 32K, 
cartridge module 

23 At{nimount, 44K, 
cartridge module 

23 Minimount, 64K, 
cartridge module 

23 Minimount, 32K, 
cartridge module 

23 Minimount, 64K, 
cartridge module 

23 Minimount, 44K, 
cartridge module 
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lists Level 6 equinment and options supported by MOD 400 


5<slot, 
9=slot, 
5=slot,. 
G~eslot, 
S-slot, 
9=-slot, 
5-slot, 
S-slot, 
7=slot, 
7~slot, 
7=slot, 
7=slot, 
T~slot, 
T=slat, 


Table C<1 (Cont). Supported Hardware ~ Model 23 


Marketing 
Category _Identi fier Description 2 


Consoles DK U9 101 VIP 7100 console, ei acharacter 
DKUS 102 VIP 7100 console, 96=character 
DKUS 103 VIP 7200 console, 64=<character 
DK U9 104 VIP 7205 console, 96=—character 
TWUS 104 30CPS console typewriter 
TWUS 106 I20CPS console typewriter 
TWU9 108 30CPS console with numeric keypad 
. THU9TIO . 120CPS console with numeric keypad 
Printer PRM9 301 M23 printer adapter 
Adapter 
Line PRUS 103 24OLPM printers 94—character set 
Printers PRUS 104 SOOLPM printer’ 64=<character set 


PR U9 105 440LPM printer! 96—character set ae: 


PRU 106 SOOLPM printer? 464—character set 
PRUS 108 S660LPM printer’ 946—character set 
_PRUD 109 9OOL PM printer 64~character set 


‘Metets: PRUY 112 Matrix printers !20CPS 
Printers PRUD 114 Matrix printers !60CPS 


Diskette - DIMN9301 23 dtekette adaccer 
Adapter 


Diskettes DIUg 101 “Styade-aiaketts édinglessiseds 

256KB 

DI u9td2 Sual-diskette (single-sided) $ 
2x 256KB 

DI uU9IO3 Single-diskette (double-sided): 
512K3 

DI US104 Dualediskette (double-sided): 
2x512K3 


CDS9 336 
CDS9 337 


Cartridge 
Module Disks 


26MB cartridge module disk in cabinet 
with 23 controller 

2x 26M3 cartridge module disk in cabinet 
with 23 controller 

BOMB cartridge module disk in cabinet 
with 23 controller 

2x80MB cartridge module disk in cabinet 
with 23 controller 

26MB cartridge module disk in cabinet 
without controller 

2x 26M3 cartridge module disk in cabinet 
without controller 

SOMB cartridge module disk in cabinet 
without controlier 

2x80MB cartridge module disk in cabinet 
without controller 


CDS9 338 
CDS9 339 
CDUS 136 
CDUS 137 
CDUS 138 
CDU9 139 
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Table Cel (Cont). Suoported Hardware ~ Model 23 


Marketing 
Category Identifier Deseriotion 
BT 


Communication DCM9 301 M23 communication adapter: 2 asyn- 
Adapters chronous lines 
DCM9302 M23 communication adapters | syn= 
chronous lines 
DCM9 303 YV23 communication adapter: 2 syn=- 
ehronous lines 
DCMS 304 M23 communication adapter: 1 syn= 
chronous ard |! asynchronous line 


Terminals Asynchronous 
Terminals 


VIP7I90 CRT terminal, 64=-character set 
VIP7105 CRT terminal, 94—-character set 
VIP7200 CRT terminal, 44-character set 
VIP7205 CRT terminal, 96=character set 
VIP7380] CRT terminal, l2=inch screen 
VIP7902 CRT terminal, 15-inch screen 
VAF 7321 Buffered orinter adapter for all 
VIP 7300 terminals 
TWUIOOT Keyboard/orinter, 30 eps 
TWUINO3 Keyboard/printer, 30 cps 
TWU 1005 Keybdoard/orinter, !20 eps 
PRUIOO} Printer terminal, 30 cps 
PRU1I903 Printer terminal, 30 cps 
PRUI 005 Printer terminal, 120 ens 


Synchronous 
Terminals 


VIP7700 terminal, 62-character 
VIP7705 terminal, 95—-character 
VIP 7700R terminal, 63-character 
VIP7705R terminal, 95=-character 


VIP7TTAO terminal, 95<character 
Subsystem 


VIP7804 CRT terminal, !2-ineh sereen 

VIP7805 CRT terminal, |5-inch screen 

VAF 782 Buffered orinter adapter for all 
VIP 7800 terminals 


RQP Printers] ROP printers are generally supported 
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Table C=1 (Cont). Sunported Hardware = Model 23 


Catejory Description 


Modems Modems suposorted for asynchronous communications 
terminals ares 


» 103, 113, 202 type modems. (These modems must be 
equipped with the option to disconnect the data 
set after ae carrier drop of i110 milliseconds). 


CII HONEYWELL BULL modem bypass, 


Modem tyses where the connection, disconnection, 
and data set control settings can be 
user-specified. 


Modems supsxorted for synchronous communications 
terminals ares 


« 201, 201A, 201C, 208, and 2088 tyne modems, 
« CII HONEYWELL BULL modem bypass, 


Modem tyses where the connection, disconnection, 
and data set control settings can be 
user-specified. 


e Broadband modem, 


A modem is not required for a direct=connect 
asynchronous terminal, or a synchronous terminal 
with a timing source in the terminal or in the 
MLCP. 
Writable Control Store (CPF9509) is offered for 

Building system builder use only. Although Writable Control 

Products Store is usable under GCOS 6 MOD 400, full end-user 
software support is not available, 
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Table C=-2. Hardware Sunoorted ~- Model 3X, 4X and 5X 


Marketing 
Category identifier Description 


Central CPS9470 Model 33 Central Processors} 
Processors CPS947!t memory to 64K words 7 
CPS9472 

CPS9473 


CPS9540 Model 43 Central Processors? 
CPS9S56! memory to 1024K words 
CPS9542 

CPS956 3 . 


CPS95A6 Model 47 Central Processors} 
CPS9567 Commercial Models memory to 
1024K words 


CPS9570 Model 53 Central Processors? 
includes ¥MU and Caches memory 
to 1924K words 


CPS9572 Model 57 Central Processors} 
Commercial Model weith MMU and 
Caches memory to 1024K words 


Multiple MDC9 101 Multinle device controller 


Device 
Controller 


Console KCM9 IOI Keyboard console device=pacs 
De vice=pac 


Consoles DK UVIOI VIP 7100 console 
DK US FO2 VIP 7105 console 
DK U9 103 VIP 7200 console 
DK U9 104 VIP 7105 console 
TW U9 104 300CPS console typewriter 
TW U9 106 [20CPS console tyoewriter 
THUS 108 3OCPS console with numerte keypad 
THUS 110 120CPS console with numeric keynad 


Printer PRMOIOt Printer device=-pac 
Device~oac _ 


Line Pelaters PRUD103. 240LPM, 96=character 
PRUD 104 300LPM, 64-character 
PR U9 105 440LPM, 96—character 
PR US 106 6O0O0LPM, 44=<character 
PRUP 108 660LPM, 94—-character 
PRUD 109 QJOOLPM, 44-character 


Mates PRUDII2 . 120CPS matrix orinter 
Priaters PRU9 114 i60CPS matrix orinter 
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Table C-2 (Cont). Hardware Supported — Model 3X, 4X and 5X 


Marketing 
Category Identifier Descrintion 
Card Reader ~CRM9 101 Card reader device=pac | 
Device=pac 


Card Readers CRUD 108 3OOCPM 
CRUSTO9 300CPM, IBM mark sense 
CRUV1IO 300CPM, HIS mark sense 
CRUS III 500CPM 
CRUGI1I2 _ SOOCPM, IBM mark sense 
CRUP 113 500CPM, 


sense 


Device~Pac for card punch and card 
reader /punch 


Card Punch and; CRM91I03 
Cari Reader/ 

Punch Device= 
Pac (Adapter) _ 


Card Punch | _PCWwION Card punch. 100 cpm 


“CCU 101 Card reader/punch, 400/100 epm | 
Punch 


Diskette: “DINO 101 Diskette device-vac for 2 single=- 
Device=pacs sided diskettes 

Diskette device-pac for (2) l= or 
2-sided diskettes 


DIM? 102 


DIU9 101 Single diskette (single-sided), 


Diskettes 


2546KB 
DIUS i02 ual diskette (single sided), 
2x2556K3 
DIU? 103 vt ee diskette (double-sided), 
1 2KB 


DIUS 104 Duel diskette (double-sided), 


2x51 2KB 


IOMB (545) cartridge disk with 
controller 

JOMB (545) additional disk without 
controller 


CDU9 116 
CDS9 116 


Cartridge 
Disks 


26MB (13F + 138) in cabinet with 
controller 
26MB in cabinet with controller 
80MB (67F + 13R) in cabinet with 
controller 
Dual 80MB in cabinet with 
controller 
26MB in cabinet without controller 
Dual 26MB in cabinet without 
controller 


Cartridge COS9 136 
Module Disks 


C0S9 137 
CDS? 138 


CDS9 139 


CD UP 1346 
CDU9 137 
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Table C-2 (Cont). Hardware Supported = Model 3X, 4X and 5X 


Marketing 
Category Identifier Description 


Coug 138 80MB in cabinet without controller 

CDU9 139 Dual SOMB in cabinet without 
controller 

26MB (13F + 138) with controller 

80MB (47F * 13R) with controller 

26MB add-on unit without 
controller 

80MB add-on un{t without 

controller 


COS9 123 
CDS9 525 
CDU9 123 


CDU9 125 


Mass Storage MSS9 102 


Units 


Mass storaje un{t in cabinet with 
controller 


MSS9 104 256MB mass storage unit in cabinet 
with controller 

MSS9 107 Dual 67MB nass storage unit in 
cabinet with controller 

MSU9 102 $7MB Mass storage add-on untt 
without controller 

MS U9 104 256MB mass storage add~on unit 
without controller 

MSU9 i07 Dual 67MB mass storage add-on unit 


without controller 


MTC9 101 
“MTC9 102 


Magnetic Tape 
Controllers 


tape controller, NRZI 


Magnetic 
drives 

Magnetic tape controller, PE/NRZI 

drives 


MTM9 101 
MTM9 102 


Magnetic Tape 
Device-racs 


Magnetic tape Device-oac, 7~track 
drives 

Magnetic tase Daevice-oac, 9-track 

drives 


MTU9 104 
MTU9 105 


Magnetic Tape 
Drives 


NR2Z1, 


Magnetic tape drive, 9=track 
45 inches per second (ios) 
Magnetic tane drive, 9-track NRZI, 


75 tips 

MTU9 109 Magnetic tape drive, 9=track NRZI/ 
PE, 45 tps 

MTU9 110 Magnetic tape drive, 9-track NRZI/ 
PE, 75 fos 

MTU9 112 Magnetic tape drive, 7-track N&ZI, 
45 ios 

MTU9S113 Magnetic tame drive, 7etrack N&ZI, 
75 fos 

MTUS 114 Magnetic tane drive, 9—track PE, 
45 {ps 

MTUO IES Magnetic tape drive, 9=track PE, 


75 ips 
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Table C-2 (Cont). Hardware Supported - Model 3X, 4X and 5X 


Marketing 
Category Identifier Description eae 


Communication MLC9103 
Controllers MLCO IO! 


MLC9 102 
MLCS 104 


Comaunications DCM9 101. 


Pacs 
DCM9 102 


DCM9 103 
DCM9 104 
DCM9 105 


DCM9 106 
DCMS 108 
DCM9 109 
DCM9 110 


DCM9 11 1 
DCM9 T12 


DCMS 113 


DCMS 114 
DCM9 315 


DCMS 116 
DCM9 120 


DCM9 121 


DCM9 126 


Multiline communications processor 
MLCP with 8 asyn¢ehronous lines? 
includes 4 communication-pacs 
MLCP with 8 synchronous lines?’ 
includes 4 communication=-pacs 
MLCP with 8 current loop liness 
includes 4 communication=epacs 


Communications=pac, two asynchro=- 
nous lines, cable 

Communications=-pac, one asynchro= 
nous lines, cable 

Communications=pac, two synchro= 
nous lines, cable 

Communications=pac, one synchro= 

_nous lines, cable 

Communications~-pac, one current 
loop line (Bell 301/303 modem 
comatible) 

Communications-pac, one medium 
speed, synchronous, HDLC line 
Communications=-pac, broadband line 

(CCITI/V35 compatible) 
Communications=oac, two synchro- 
nous lines (MIL 188C compatible) 
Communications=pac, Autocall Unit 
for one or two synchronous or 
asynchronous lines 
Communications=pac, one asynchro= 
nous current looo line 
Communications<pac, broadband HDLC 
line (Bell 3017303 modem comnat- 
ible to 72KS) 
Communications-pac, broadband YDCL 
line (CCITTI/V35 compatible to 
72KB) 
Communications=-pac, two asynchro- 
nous current loop lines 
Communications-pac, broadband syn- 
chronous line (MIL 188C compate 
ible to 54KB) 
Communications=pac, two asynchro= 
nous lines (MIL 188C compatible) 
Commnunitcations—-pac, HDLC to 19 2K3 
MIL 188C 
Communications-pac broadband HDLC 
MIL 188C 
Communications=-pac INCOTERM 
connection 
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Table C-2 (Cont). Hardware Supported = Model 3X, 4X and 5X 


Marketing 
L__ Category _| |_identifier | re SC iption 


Seratnete: 1 I eyacheonsus | 
Terminals 


Vire?7190 CRT terminal, 64<character set 
VIP7105 CRT terminal, 96~character set 
VIP7200 CRT terminal, 44—character set 
VIP7205 CRT terminal, 96~character set 
VIP7300 CRT terminal, !2~inch screen 
VIP7802 CRT terminal, !S-inch screen 
VAF 7821 Buffered orinter adapter for all 
VIP 7800 terminals 
TAUI OO! Keyboard/printer, 30 cos 
TWUIOO3 Keyboard/printer, 30 eps 
TWULOOS Keyboard/orinter, 120 cos 
PRU!001 Printer terminal, 30 cps 
PRUt003 Printer terminal, 30 cops 
PRUI 005 Printer terminal, !29 cps 


Synchronous 
Termi{ nals 


VIP7700 CRT terminal, 452-character set 
vVIp7705 CRT terminal, 95~character set 
VIP77OOR CRT terminal, A3-character set 
VIP77OSR CRT terminal, 95=-character set 


VIP7760 CRT terminal, 95—character set 
Subsystem 


VI P7804 CRT terminal, !2-inch screen 

VI P7805 CRT terminal, !S-inch screen 

VAF 782 1 Buffered orinter adapter for all 
VIP 7800 terminals 


ROP Printers |] ROP printers are janerally 
supoor ted 
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Table C=2 (Cont). Hardware Supported = Yodel 3X, 4X and 5X 


Modem supsorted for asynchronous communications 
terminals aret 


e 103, 113, 202 type modems. (These modems must be 
equiped with the option to disconnect the data 
set after a carrier drop of 110 milliseconds). 


CII HONEYWELL BULL modem bypass, 


Modem tyses where the connection, disconnection, 
and data set control settings can be 
user=specified. 


Modems supported for synchronous communications ae 
terminals are? 


201, 201A, 201C, 208, and 2088 tyne modems. 
CII HONEYWELL BULL modem bypass. 


Modem tyses where the connection, disconnection, 
and data set control settings can he 
user~specified. 


o Braadband modem. 


A modem is not required for a direct=connect 
asynchronous terminal, or a synchronous terninal 
with a timing source in the terminal or in the 
MLCP. 


Writable Control Store (CPF9509) is offered for 
Building system builder use only. Although Aritable Control Zt 
Products is usable under GCOS 6 M29 400, full end-user 

software support ts not available. 
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APPENDIX D 
POWER RESUMPTION 


NOTE? The Power Resumption facility is not supported on systems with 
an MLCP=connected Operator’s console. 


The power resumption facility allows the system execution 
environment to be restarted after a power interruotion. The central 
processor must have the memory save and autorestart unit. This unit 
can preserve the memory imajye through a power fatlure lasting up to 
two hours. It cannot, however, preserve the state of the [/0 
controllers, ensure that no operational changes have been made to 
the nounted volumes, nor preserve the contents of the multiline 
communication orocessors. Restoration of this system itnformation is 
accomplished through the power resumotion facility. 


If fewer than two hours have elasped when power is returned to the 
central orocessor, the power resumotion facility performs the 
following actions: 

- Reinitializes the [/0 controllers 

« Reconnects terminal devices (TTY and ATD devices) 

- reestablishes the integrity of nounted volumes 


« Restarts the communications subsysten (TTY and ATD devices 
only} 


« Restarts the application tasks that were active at the time of 
the failure 


« Signals a power resumption software trap to tasks that have a 
handler enabled for this trao 


« Restart Display Formatting and Control processing 


If tne power remains off for more than two hours, the nemory image 
is destroyed and the oower resumption facility is disabled. The 
“memory On” tndicator contained in the memory save and autorestart 
unit-is lit. The operator tust manually reset this tndicator before 
rebootstraoping the system to oerform a restart. See the Mini 6 


Mintcomputer Systems Handbook for detailed infornation about the 
_-. . « memory save ani autorestart unit. Sea the Ooerator’s Guide for 


Ne 


orocedures used in restarting after 4 system failure. 
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POWER RESUMPTION CONFIGURATION REQUIREMENTS 


To implement the power resumption capability, you must configure the 
following 


« Memory save and autorestart unit 
« Power resumption facility 
« Automatic terminal reconnect 


Note that peripheral devices (those devices not attached to an MLCP) 
are designated automatically reconnectable when they are configured 
at system building. These devices are reconnected when power is 
restored. 


Configuring Memory Save and Autorestart Unit 


Pour small recker switches, located behind the full control panel on = 
the control panel circuit board, supply configuration information to 

the central orocessor. The switch on the extreme left (when the 

panel is ooen) is the volatile memory switch. It must be set off 

(pushed down) to inform the system that the memory save and 

autorestart unit is present. 


NOTE2 On some control panels, the volatile memory switch is on the 


extreme right. See the Mini 6 Minicomputer Systems Handbook 
for complete details. 


Configuring Power Resumption Facility 


You add the power resumption facility to your system by {neluding 
the following LDBU directive in the Configuration Load Manager (CLM) 
file. 


~~ 
LOBU ZXPFR 
See Section V for a descriotion of the LDOBU directive. 
Configuration Automatic Terminal Reconnect 
Each communication device (each terminal connected to an MLCP) that 
is to be automatically reconnected by the power resumption facility 
must be so designated using the STTY command with the -RECONNECT 
argument in your CLM file. See the description of the STTY command 
below. 
~ 
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STTY COMMAND 


Command Names STTY 


Change or display the file characteristics of a communications 
terminal. Can be used as an alternative to the STTY directive 
format in the Configuration Load Manager (CLM) file. Provides 
features not supported by the STTY directive. You must tnclude an 
STTY command in your CLM file for each terminal that you wish to 
configure as being reconnectabdle in the event of a system power 
failure. . 


Format? 


STTY (devica_name] ctliarg 


Argument Descriptions 

device_name 

The t= to 6-character device name Of the terminal’ use of the 
exclamation point character as a prefix {is optional (e.g., TTYO! or 
!TTYO! can be used). 

UVefaultt The terminal from which this command ts issued. 

ctllarg 

Qne or more of the followtng control arguments must be specified, in 
any Order. [f an argument [s unspecified the corresponding current 
value for the terminal remains in effect. 

wLL A 


Decimal {integer specifying the desired line length. This value 
excludes the control byte. 


I 
“TYPE +3 | 
B 
Set the device type to Lnout-only (1), output-only (0), or 


Sidirectional (8). 


‘=TABSIM YES 
NO 


Insert space characters, where needed, to simulate ta>bing. If 


the terminal does not susport tabbing and the output data has tab 
characters, specify YES. 
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ow {3 


Prepare the device to receive asynchronous buffered (A), 
synchronous buffered (S), or nonbuffered synchronous (N) input. 
(See the “Function Description" for a description of 
asynchronous, synchronous, and buffered). 


A 
“OUT 4 S 
N 


Prepare the device to transmit asynchronous buffered (A), 
synchronous buffered (5S), or nonbuffered synchronous (N) output. 
(See the "Function Description" for a description of 
asynchronous, synchronous, and buffered). 


“~RECONNECT } YES 
NO 


Specifies whether or not this terminal should be automatically 
reconnected following a 3ower fatlure or line drop condition. If 
YES is specified, the terminal will be automatically 
reconnection. If NO is specified, no automatic reconnection will 
take place. The default is Ni, 


“PRINT 


Display the current characteristics (name, device-type, line 
length, ete.) for the terminal. 


-MODES mode eee 


Set the terminal to operate in the specified mode(s)}. To reset a 
mode, precede the mode with a circumflex (*). For example, =MODES 
EcdO, “*HANG_UP sets the terminal to echo keyboard input and to 
"not" hang up the phone when the file is closed. Any number of 
modes can be set or reset in any combination, in any order. If a 
particular mode is not svecified, that mode is not changed. 
Possible modes are listed below. To set a mode, you must know 
which line protocol handler (LPH) is servicing the terminal. The 
“PRINT argument can be used to disolay the current mode settings 
to determine which modes can be set or reset, 
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SCH) 

AUTO_CALL } 

AG 

Lan a 
TR 


{ STOP_OUTPUT } 
Si} 


pero 
LF 
CARE TACE AE TUEN 
CR 
ee te } 
CB 


fay 


eat 
HU 
HOWE 


ECTN 
DEL 


Meaning 
Echo keyboard inout. 


Use the Auto~Call unit when the 
file is opened, 


Input data is in transparent 
modeée. ; 


If an sutput order is in proge 
ress, stop it {mmediately if a 
BRK {5s issued from the terminal. 
Line feed at end Of message. 
Carriaye return at end of 


messaje. 


Qutput sent to the terminal 
starts with a control byte, 


Data transfer is in buffered 
(block) mode, not character 
mode. 


Hang up the phone when the file 
is closed. 


Set cursor to home on page 
overflow, 


Suosort VIP function codes. 


Include received DEL characters. 


LPH 


. TTY,ATOCI) 


ALL 
TTY,ATD,BSC 


TTY ,ATD 


TTY,ATD,VIP, 
STD 
TTY,ATD,VIP 
STD 

TTY ,ATO,VIP 
STD ,BSC 

TTY ,ATD 

ALL 


VIP,STD 


VIP,STD,PVE 
PVE 


The following saecial keywords can be used with 


the VIP Line protocol handler to set various 


time-out and polling intervalss 


Time=out immediately (after ! 
poll). 


Time=out after 10 minutes of 
polling. 


No timeout ({.¢., indefinite). 


No polling interval (i.¢., 
continuous). 


l-second poll interval. 
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VIe,STD 


VIP,STD 


VIP,STD 
VIP,STD 


VipP,STD 


Mode Meaning LPH 


Pi2 2-second poll interval. VIP,STD 

PI3 3=second poll interval. VIP,STD 

PI4 4=-second poll interval. Vir,STD 

PIS 5esecond poll interval. VIP,STD ~ 

PII5 15<second poll tnterval. vieP,.STD 

PI39 30=second poll interval. VIP,STD 
“RESET 


Reset the modes to those designates at system building. 
DSWI 


Set the terminal’s device=specific word ta be used at open 
Ceonmect) and close (disconnect) times this argument is an 
alternative to using the =-MODES argument. h ts a 4-character 
hexadecimal value. This argument requires detailed knowledge of 
terminal I[/0 and should be used only if you understand line 
protocol handlers and have read the Comnunications Processing 
manual. 


-DSA2 4 


Set the terminal’s devics_soecific word to be used when the file 
is read or written’ this argument is aa alternative to using the 
“MODES argument. 4 is a 4<character hexadecimal value. This 
argument requires detailed knowledge of terminal [40 and should 
be used only if you understand line protocol handlers and have 


read the Communications Processing manual. 
NOTESS 


1. Only the current device=specific word assignments can he 
modifieds i.e., not the tnitial device-specified words 
established throuj4 the STTY directive during system 
building. 


2. No consistency checks are made? if the =DSWI or -DSW2 
argument specifies logically inconsistent or imoossible 
conditions, relative to the actual device type, no 
notification of error is given and the indicators are set 
as requested. 


D=04 


FUNCTION DESCRIPTION? 


The set terminal characteristics (STTY) command permits you to 
modify or display the file characteristics associated with a 
terminal or endpoint that ts not currently reserved. The original 
terminal characteristics, established during system building, can be 
altered to reflect your current needs. To use the -IN and QUT 
arguments, you must understand the meanings of the terms buffered, 
asynchronous, and synchronous. These terms are described below. 


Buffered means that an intermediate data storage area its used before 
data 1s transferred to/from a device. For iaput, data is received in 
systam memory and then moved to used memory. For output, data is 
moved from used memory to system memory and then to the device, 
Nonbu ffered means that data is transferred directly from user memory 
to the device. 


Asachronous data transfer Ls the concurrent transfer of data and 
execution of an aoplication programs f.e., processing can continue 
during a read/write operation. SSyneneonens apéerations are always 
buffered. 


In synchronous data transfers, processing waits for completion of a 
read/write request. Control returns to the requestor after the 
transfer is comolete. Synchronous ooerations may be buffered or 
nonbu ffered. 


The ooeratiny charactert{stics of the application orojgram determine 
whether asynchronous Suffered (A), synchronous buffered (S), or 
synchronous nonbuffered (N) are specified in the -IN and -QUT 
arguments. Generally, 1f an application program is directed towards 
multiole terminals, specify A so there is full user interaction. If 
Sor N ts specified and sonteone {issues a read Or write, all other 
users have to wait. This is explained in nore detail below. 


Nith asynchronous input, if an application program tssues a read 
request, the system waits for previous read ooerations to conplete. 
The data is moved to the aonlication program, the read request just 
issued is placed in a queue, and control immediately returns to the 
application program. If the aonslication orogram {ts interacting with 
only one terminal, asynchronous inout is efficient, but not 
necessaryt the apslication jdrogram can process a message while the 
file system reads the next message. Asynchronous input {is necessar 
for an application program to interact with multionle terminals. ror 
multiterminal aoplications, an application program may poll 
terminals and wait for {nput from a List of terminals. 


Asynchronous output permits “double buffering" output requests. Ahern 
an aoolication orogram issuas a write request, the system waits for 
previous write requests to complete. Jata ts moved from the 
application program to a system buffer, the write request its slaced 
in a queue, and control immediately returns to the application 
progran. 


WOTe* For single-terminal applications using the roll-out feature, A 
or S orovides more efficient ooeration. 
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mxamo les 


STTY !VIPOI -MODES “CONTROL_LBYTE ,*STOP_LOUTPUT, 
AUTO_LCALL, “HANG_UP 


or 
STTY VIPO) -MODES *CB,*S0,AC ,*HU 


File {nout/output to VIPQ!] will not expect a control byte before 
each Output message. Finish printing output message that may be in 
progress when a BREAK is detected, Use the Auto=-Call unit when file 
is opened. Do not hanj up the phone when the file is closed, 


ACTIONS FOLLOWING POWER RESUMPTION 


When the power resumption facility restarts the execution 
environment, it automatically oerforns a number Of system functions. 
When the Operator and system users are notified that power 
resuanption has occurred, they may he required to perform certain 
actions. 


Automatic Funetions 


The power resumption facility automatically performs the following 
functions & 


o Restarts the device drivers, clock, and communications 
subsystem. 


o Reconnects peripheral devices. Reconnects terminal devices that 
were desijynated as being automatically reconnectable. 


o Resets the system date and time. (The date/time clock has a 
separate battery backuo units it 1s supported through the 
real-time adapter). 

« Reloads the memory management unit. 


« Restarts all tasks that were active when the power failure 
Occurred. ; 


In addition to these automatic functions, the system Operator and 


systen users may be reouired to perform certain actions. These vower 
resumption procedures are deseribed in the Qoerator’s Guide. 
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APPENDIX E 
DATA ENTRY FACILITY = I 


This Aopendix deseribes a typical configuration procedure that can 
be used to accommodate DEF=-I, and list the Linker directives that 
are required to link a DEF=[ system. : 


CONE IGJRATION 


GCOS 6 MOD 400 software requires that the following steps be 
performed before the Data Entry Factlity=-[ can be used: 


1. During system building, ensure that the directives required by 
the DEF=-I system are included in the CLM_USER file. 


2. Jenerate a DEF-I system Linker directive file that supoorts 
the user’s CLM_USER file. 


NOTE To aid in steps | and 2, a sample DEF-especific Linker 
directive file (DEF_SAMPLE.S) is susplied on the media. 
It may be modifled to meet the requirements of the 
particular installation. 


3. Execute a Linker run to produce a DJEr-I[ bound unit. 


4. Optionally, execute a Linker run to produce a user suoolied 
date entry program, 


5. Generate the appropriate DEF-I[ system user group and Start-up 
task command files. 


To ald in an understanding of this process, a samole DEr<-I system 
configuration is used throughout this anpendix. 


Configuration parameters includet 


4 Operator display stations 

1 line printer 

1 data entry orogram overlay area 
2 DEr=[ background tasks 
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CLMLUSER F 


After the GCOS 6 MOD 400 system nas been initially loaded by a stage 
i system startup, you must define a file of configuration 
directives, called the CLM_LUSER file, for the Configuration Load 
Manager (CLM). This file will contain the Symbolic Peripheral! Device 
names (SPD), communications arguments, and memory pr0l assignments 
necessary to use GCOS 6 MOD 400 software on a Mini 4 system. 


The CLM_USER file directives need not be completely DEF-specific. 
That is, the devices, memory, etc., described in the CLM_USER file 


May be shared by other system function facilities and may include 
specifications not required for the Data Entry Facility-I. 


Sample CLM_USER File 


Figure E-! {llustrates a CLM_USER file for a Data Entry Facility. 
. The file specifies a system with four operator display stations, one 
attached through an MDC (CONOI) and three attached through an 
MLCP/OLCP (TTX). Additionally, there are two diskettes and a line 
printer. (The bootstrap device is left implicit here). 

DEVICE KSROO,0,5,X70509% ,CONSOLE ,140 

COMM 7 

TTX 12,8,X7FF00% .0,9400 

" TIX 13,9,X“F 80" ,0,9600 
DEVICE CONOI 14, 10,X“0580% ,CONO! ,80,N,%7200% ,T 
TIX §15,113,X%cE80% ,0,9400 


PVE 16,16,X’FCO00%, 2,00 


PVE 17,16,X“FCO0" 2,01 


DEVICE DSKOO,5,14,X% 04807 
DEVICE DSKOI .6,15, X% 0480/7 
DEVICE CPTOO,8,17,X% 1380" ,LPTOO 
MEMPOOL S, 5000 

. MEMPOOL ,AB,*® 
SYS 44+5,20,80,,£ 
QUIT 


a nr 


Figure E=-1. Sample CLM_USER File 
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\.  CLM_USER File Directives 


The following CLM_USER file directives are used for a system that 
includes Der=[. 


DEVICE DIRECTIVE 


A DEVICE directive is required for each device=-except a 
communications (MLCP/OLCP-connected) operator display station—-used 
with JEF=I. (A JEVICE directive may be paired with a TTX directive 
used for a comnunications overator display station if the device is 
to be accessible through the file system interface). The DEVICE 
directive is described in Sections V and VIt in addition, note the 
following points! 


« A noncommunications (WY3C-connected) operator display station 
requires the device arguments snecifying non-buffered teletype 
mode of the DEF=-I workstation he used (see Section V). 

- If a DEVICE directive is oaired with a TIX directive (described 
below), the DEVICE directive’s device_unit argument value aust 
bé TT¥nn (See Section VI to ascertain the Jjevice 
characteristics achieved by TTYnn). for examole: 

Table E=i List the devices configured in figure C-! and their 
associated device_unit argument values. 


Tadle E=-!. Jevices Configured tn Fijyure S-] 


Number Device_Unit 
Device Type Conf ijured Argumant Values 


= mse —- - 
.[ Sonsote TRIG 
Qoerator Disslay CONO! 
Station—~=MDC- 
2 et connected TTY # 
| Dt skette pskoo,oskoi (sf 
Line Printer | 4 LPTOO ' : 
When nore than one Operator display station ts configured for DEF-[, 
those CRT“s must be assigned consecutive logical resource number 
(LRN%s). Similarly, all system Line printers used by DEF-[ must be 
assigned consecutive LRNZs. 
Ne 
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In figure E=1, the four operator disolay stations use the sequential 
LRNYs 12, 13, 14, and 15. 


Also note that the number of devices configured in the CLM_USER file 
may be greater than those specified when linking the DEF=! systen 
(see below). Thus the DEF=-I bound unit may be linked for three CRT“s 
even if the CLM_USER file specifies four. 


COMMUNICATIONS SYYSTEM DIRECTIVE 


Tne COMM directive specifies that a communications subsystem is 
used. In figure E=!, the communications subsystem {s given a 
hardware interrupt level of 7. High oriority hardware levels should 
be used for communications interrupts to ensure satisfactory 
operation. 


TIX DIRECTIVE 


The TIX directive specifies a TTY=tyse communications device. 
raowever, unlike the TTY directive, it provides an 80=character 
buffer. This buffer, and therefore the TIX directive, is required 
for all DEr=-[ Operator display stations attached through an 
MLOP/OLCP. 


The TIX directive appears as follows: 
TIX Irn, level, X% channel’ ,{ modem}{ , sp eed} 


Refer to the TTY directive tn Section VI for a description of the 
. FTX arguments. 


In Figure =i, there are three MLCP/DOLCP connected operator display 
stations, and therefore three TIX directives. 


MEMORY POOL DIRECTIVES 


A MEMPOOL directive fs used to specify the system memory pool size. 
Additionally, an online user memory poole-either exclusive or 
nonexclusive==-must be specified for the DEF=-I system. The minimum 
required size denends upon which DEF-I system functions are linked 
as resident and which are Overlays, and upon the number of DEr-I 
workstation buffers required. Memory requirements are further 
described under “Linking a JEF-I System" below, The MEMPOOL 
directive is described in Section V. 
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In Figure E-!, the DEF~I system is configured with a single 
nonexclusive online memory pool with the name A3s: this sool extends 
from the end of the system nemory pool to high memory. This single 
2901 can be used by the DEF-I system and by any other function in a 
jroup assigned to this pool, e.g., the COBOL comoller. 


SYSTEM DEFINITION DIRECTIVES 


The SYS (system defin{tion) directive is described in Section V. The 


= 


following consideration anolies to D&ér~f. 


It ts advisable to create several system overlay areas to improve 
the likelihood that a needed overlay is already present in memory 
(because it was recentiy us2d) and does not have to he reloaded. 
This ts done through the “olan” argument of the SYS directive: 5 is 
a recommended value, 


It {is also recommended that the user allocate additional interruost 
request blocks for each DEF-I workstation. In Fiture Ex!, 80 
interrupt request blocks have Deen aided for four workstations. This 
configuration suooorts activities in a high=throujhout data entry 
environment. [mn a more casual data entry environment, anrornximatealy 
10 additional interruot request Slocks ver workstation would he 
adequate. 


LINKING A Derel SYSTOM 


The following paragraphs describe the requirements for linkina? 


» A DErF-I system bound unit 
e A DErW-I data entry programs bound unit 


The Linker directives are discussed in the Program Executive and 
Checkout manual. 


IEF System Directories 


The OSF-I system object units are located {n the directortes listed 
in Table E-2, depending up tn the system software neditm. 
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Table E=2. DEF=I Object Unit Directory Pathname 


‘Diskette “*ZSYSIO>ZDRT 

Cartridge Disk “2 SYS51>ZDRT 

Mass Storage Jnit #2 5YS71>ZDRT 

Cartridge Module Disk “2 SYS6 1>ZDRT 
DEF System Object Units ; 
Tne Der system object units are grouped in Table E*3 according to 
function. Some of these units are linked internally, and do not 
need ta be specified when Linking DEF]. 

Table Exw3. DEF=<I Object Units we 


pF System object Units System Object Units 


Control ZD=LTD, ZUFCRT, ZDOF INI, ZDFSTB, 
: ZD&CTL ZDFNDH, ZDFBM, ZDFPH, 
ZDr LAD ZDFPRW, ZDFOLY, ZDFUSG, 
ZDFLTH, ZOFSR!, ZDFLOK, 
ZDF SRD 


Background Control ZDr BGR 
Qperaton Security ZDFOSR 


Qperator Statistics ZDé STA 


Function Ob ject Units 


Applications Processor; 
Vata entry Processor ZDe DE | ZDFDE2, ZDrDE3, ZDFDE4 


Forms Processor ZDF aM I ZOFFM2, ZDFFM3, ZDFFM4, 
ZDFFMS 


Pile Print Processor ZDFeP 
Tables Processor ZD= Te 


Utility Functions ZDeUT 
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Table E=-2 (Cont). DEF_I Object units 


Speci fied Not Speci tied 


ZD-SPi, ZDFSP2, 
(Z0ePUP ) 


20° VE 


Suoer visor Functions 


Verification Processor 


Additionally, dummy units Listed in Table E~4 are provided so that 
specific DEF-I functions such as operator security, operator 
statistics, and vassword uodatina need not be ftucluded in the 
system, 


Table E-4, DEF=-I Dummy Object Units 


|__duny oniect unit | 


‘Guuaslicatians. o7eappSSCSC*d 


Data Entry ZDFDE) 


Form Creation ZDFF Mi 
Pile Printing ZOFFPD 
Table Creation ZOF TBD 
Utilities ZDFUTD 
Supervisor ZDFSPD 
Verification ZOFVEOD 
Qperator Security ZDFQSU 
Operator Statistics ZDFS TD 
Password Updating ZDFP wd 


Not required if 
suservisor is nor 
configured). 


To create the DEF=[ system bound unit, either the real unit or the 
correspondiag dummy unit must be tneluded for each function. For 
examole, you must link either ZDFFP or ZDerere. 
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Data entry Program Object Units 


All data entry programs are ootional user=-supplied programs that are 
linked into one or more bound units separate from the DOF=-I system 
bound unit. Table E=§ lists the object units that must be linked in 
Order to orocess data entry srograms. These object units are linked 
with the data entry programs ina Linker run separate from the 
linking of the DEF=-] Sound unit itself. 


Table E-5. DErF-I Data Entry Program Object Units 


db ject_unit 


Memory Resident ZDEMR 
Data Entry Program 
Directory 


Data Entry Program Overlay ZDFD1, ZDrD2, ZDFD3, ZDFD4 
Directors 

Data Entry Program Dope ZDFOVG 
Vector Generator 


Bound Unit Organization Considerations 


Before generating a DEr<-7] bound unit, you should consider the 
following questions? 


e Ahich DEF-I functions are requirad? 

Which D&F=-I functions may be overlayed? 

Is the Operator security feature required? 
Is password updating required? 

Are Operator statistics required? 


¢ 8 @ @ 


The available DEF-] functions are as follows: 


Avolications Processing 
Data Entry Processing 
Forms Generation 

rile Printing 

Table Generation 
Utility Functions 
Supervisor Functions 
Verification Processor 


eo °* © @# @ #& &® @® 


If Data Entry is configured you nust also consider whether 
user~supplied data entry programs are required. 
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RESIDENT AND OVERLAYED FUNCTIONS 


Each JEF=I function may be Linked as memory resident or overlayed. 
Functions linked as overlays are not necessarily available to the 
display station station operator at all times. Figure E=-2 
illustrates three possible DEF=-I[ system bound unlit organizations. 
The first one {s the bound unit as linked by DEF_SAMPLE.S in Figure 
En-7. cere, only the DEF=I control function is resident and the 
rematuing functions are overlays. Functions which share a common 
overlay base address cannot be used concurrently. That is, 1% would 
not oe sossible to use the data entry and forms functions at the 
Same time, but {t {1s posstble to use the data entry and verification 
functions concurrently. It would not be nossible to use the 
interactive and supervisor functions at the sane time because the 
data entry function is loaded {nto memory when the verification 
function is selected and the data entry and supervisor fiunetions 
have 32 common base adiress. Note that the effect of Linking the 
application function so that it is never overlayed by any other 
function would be to leave it always in menory Once tt or any of tha 
ather functions has been used. This nas the same effect as Linking 
the aoplications function as memory resident. The size of the 
particular O€F=-[ system bound unit would include the sim of the 
sizes of the DEr-[ control, apolications, data entry, and 
verification functions. 


The second bound unit organization tn Figure £=-2 allows tore 
functions to be accessad concurrently. Here it would be sossible to 
use the aoolications, file srint, data entry, forms, and tables 
functions all at the same time. In this particular organization, the 
size of the bound unit is greater than the stze of the first 
Lllustration but the difference is only by the size of the file 
orint function. 


The third D&EF-I bound unit organization in Figure F-2 would take up 
considerably less memory but available functions are limited. This 
organization would be suitadle once you have created all necessary 
forms and tables for data entry and had n> further use for those or 
any other functions. 


Ahew planning the DEF={ function overlays, you must consider which 
functions are required to run concurrently in the system and arrance 
the overlayys accordinjzly. Use of concurrent functions causes the 
size of the DEr=-I[ system bound unit to increase according to the 
size of the concurrent functions. 


If a funetion is linked as an overlay but is not overlayed by aay 


other function, it will be read into nemory when first selected and 
remain in memory for the ducation of the D&FeI task group. 
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DATA ENTRY SROGRAMS 


—_ 
All data entry programs are user~sunplied ard linked into one or 
moré Pound units separate from the main DEF=I system bound unit. 
Data entry orograms can be made memory resident for speed of access 
or overlayed if effictent memory is not available. 
The linkage procedure for user programs {s described in the Data 
Entry Facility~I User’s Guide. 
RESIDENT FUNCTIONS OVERLAY AREA FOR FUNCTIONS 
‘ $ 
APEND + X‘1‘ 
DEEND + x"s0" 
me 
—— - a een 

| 

| 

! LEGEND 

i A = APPLICATIONS 

| e = Bre 

{. P = FILE PRINT 

S$ = SUPERVISOR 

T =— TABLES 
— U = UTILITIES nae ~ 
V- VERIFICATION 
FMEND + X"1" a ee os 
SPEND +x'1’ 


iLASEL AT END OF RESIDENT FUNCTIONS) 


*Includes durmmy object unite for functions not eveilebic, 


iLASEL AT END OF RESIDENT FUNCTIONS) 


rijgure E-2, DEF=J Function Resident/Overlay Organizations 
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MEMORY CONSIDERATIONS 


The following memory considerations must be keot in mind when 
deciding the DErF=I system bound unit organization, 


The amount of menory required for the DErel system bound unit 
{neludes the memory required for the resident functions plus the 
memory required for all overlayed functions that can reside in 
memory simultaneously. When all overlays start at the same dase 
address, this memory size is that of the largest overlay. 


when a given function is processing either as resident or as 4n 
overlay, all operator display stations can access that function 
concurrently (the function {ts reentrant). 


User-written data entry programs are itnked seoarately from the 
DEF=[ system bound unit and have thetr own overlay structure. Us to 
four oound units of overlayad data entry orojrats are sunoorted. The 
user may link up to 99 different data entry overlay >zrograms in zach 
oound unit or overlay area. The amount of memory available nust be 
targe enough to contain the largest data entry overlay oroaran. 
User-written data entry programs can also be Linked as nemory 
resident. [f no, they are Linked into a single, separate bound unit. 
Memory is required for the data entry program director olus the sum 
of the sizes of all user orograms uo to a maximun of 20 programs. 


Additional buffer and system memory considerations are discussed 
later in this Anoendix. 


Jerwl System Bound Unit Creation 


Creation of the JEF-[ system bound unit consists of a Linker run 
using 2 file with Linker directives that define four logical system 
categories: 


- Jer=[ system object units ; 

« DJEF-I memory resident DEr-I function object units 
« JEF~[ overlayed Dér=I function object units 

. Jcr~I[ system parameters. 


eijure E-7 is a complete Listing of samnle Linker directives 
required by a DEF-[ system. In the lLinkinjy orocedure described 


Delow, the directives in that listing are used to illustrate the 
text. 
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LINKING DEF=I SYSTEM OBJECT UNITS 


aa 
Only the DEF=-I] system object units listed in Table E=-5 must be 
linked. The remaining system object units listed in E=3 are 
internally linked and do not need to be specified. 
Table E=-6. System Object Unit Linker Otrectives 
Function | Linker Directives Otrectives 
rSystem Routines? | LINKN ZDFCTL, ZDFBGR, DFLID, 2DFIAD | 
DEF=I Contrel and 
Background control 
configured Not | configured Not Configured | 
Wperator Security “LINKN ZDFOSR LINKN ZDFOSD ey 


Qperator Statistics LINKN ZDrSTA LINKN ZNFSTO 
LINKING MEMORY RESIDENT DErF=-. FUNCTION QSJECT UNITS 


If a configured DEF-I function is to be memory resident or if it is 
to be omitted from the DEF-I system, a Linker directive listed in 
Table E=-7 must be used. 


Table E=7, Memory Resident Object Unit Linker Directives(t) 
Funetion 
Nop licasions Srocessor| LINKN ZDFAPD 
Data Entry Processor LINKN ZDFDEI LINKN ZUFDED 
Forms Processor LINKN ZOFrM) LINKN ZOFFMD 
eile Print Processor LINKN ZDFeEP LINKN ZDFFPD 
Tables Processor LINKN ZDFTB LINKN ZDFT8D 
Utility Functions CINKN ZDFUT LINKN ZDFUTD 
supervisor Functions LINKN ZDFSPI, LINKN ZDFSPD ZNFPUD 


ZDFPUP, ZDFSP2 
(See note 2) 


Verification Processor LINKN ZDFVE LINKN ZDFVED 
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NL NOTES? 


1. Several of the odfect units listed in Tables E-3 and E-4 for 


the functions in this table do not have to be specified in the 


LINKN directives because they are Internally linked. 


2. [f the supervisor function is linked and oassword updating is 
not required, specify ZDFPUD in olace of Z2!)FPUP,. 


LINKING DEF@I FUNCTION OVERLAY OBJECT UNITS 


Linker directives are required to link overlayed DEF=-I functions, if 
any. ror each function, use Linker directives to: 


1, Name the overlay 
2. Specify the base 


~ 3. Link the function object units 
4. Protect the overlay lase and end addresses. 


Table E=-8 lists the Dir-I system functions and the directives 


required to link each as an overlay. 


Table F-8. DEr-! Function Overlay Linker Directives 


Ano lication Processor 


Data =ntry 


Forms Processor 


rile rrint 


Supervisor Functions 


OVLY APOLAY 

BASE -—~= 

LINKN ZDFAP 

PROT APBASE,APEN) 


OVLY DEOLAY 

BASE ~<= 

LINKN ZDFODEI 

PROT DESASE, DEEND 


OVLY FMOLAY 

3ASE -— 

LINKN ZDFE! 

PROT FMBAS®,FMEND 


OVLY EPOLAY 

BASE -— 

LINKN ZOFFP 

PROT FOBASE, PPEND 


OVLY SPOLAY 

BASE =-— 

LINKN ZDFSe1,ZDFeuP,ZDFSP2 
PROT SPBASE, SPEND 
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Table E-8 (Cont). DEF<I Function Overlay Linker Directives 


Overlay Directives 
fable Generation |  OWLY TBOLAY 

BASE -—— 

LINK ZOF TB 


PROT TBBASE&, TBEND 


Utility Functions OVLY UTOLAY 


BASE ~== 
LINKN ZDFUT 


PROT UTBASE,UTENO 


Verification( 1} : OVLY VEOLAY 
BASE -=— 
LINKN ZDFVE 
PROT VEBASE, VEEND 


|. The verification function reoulres data entry processor 
subroutines. Therefore, {ts base starting address must follow 
the last data entry sverlay address, DFEND. 


The BASE directive must be set ups according to the user reauired 


Overlay structure. Refer to the Program Execution and Checkout 
manual for a full discussion of the BASE directive. 


If patches are aoplied to any DEF-I function object unit and the end 
address of that function is used as the base address for overlayed 
DEF=[ functions, then the base address for that overlayed function 
shouljs be specified as? 


(funetion id} END + X7507 


where (function id] is one of the twoecharacter a>hreviations shown 
above, 


a, 
cach overlay has “start” and “end” labels which must be "PROTected" 
@s shown. 
Figure E~7 is a sample listing of the Linker directives necessary to 
specify the DEr=I system and function object units. 
DEFINING DEF=I SYSTEM PARAMETERS 
Additional Linker directives are required to provide DEF-I system 
parameter values. The values must be placed in the half of a word as 
Lllustrated. 
A complete listing of the examples that Lllustrate the text is in 
rigure E=7, 

we 
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Specifying LRNs 


The following directives specify sample logical resource numbers 

(LRNs) required for NEF=$I. Unless otherwise mentioned these LRNs 
are not related to system-wide LRNs (e.9., those itn the CLM_UJSER 

file). 


Directive ; Comment 
VDEr DKLRN,X701007 /LAN OF DISK HANDLER] 
VDEF 3MLRN,X“02007 /LRN OF BUFFER MANAGER=2 
VDEF LOKLRN, X7 03007 . ALAN OF DEF FILE LOCKER=3 
YDerF INILRN,X% 05004 /LRN UF CRTI=5 
VDEF LOLRN ,X’%001 97 ZPIRST( 225) AND LAST (aX%1A%224)LRNS 
VDEF HILRN,X%O00t A’ ZPOR BACKGROUND AND OPERATIONS. 
2 OPEQATIONS ARE ALLOWED IN THIS 
EXAMPLE. 
VOer CRLRNI,X707 LRN OF MEMORY RESIDENT PROGRAM 
DIRECTOR =O (NO MEMORY RESIDENT 
PROGRAMS } 
VJEF GOVLAN!,X“1B007 /LRN Ur DATA ENTRY PROGRAM OVERLAY 


DIRECTOR t =X%1B% 227 DECIMAL 


VDEF OVLRN2 , X40 “LAN OF DATA ENTRY PROGRAM OVERLAY 
DIRECTOR 230 (OVERLAY AREA NOT VJSED) 


VOer OVLANI,X70% “LRN OF DATA ENTRY PROGRAM OVERLAY 
DOfRECTOR 3=0 : 


VOEF OVLRN4,X“0% 7LRN OF DATA ENTRY PROGRAM OVERLAY 
DIRECTOR 420 

Note that data entry overlay directors 2 through 4 are given LANs of 
Q Because they are not being used. 
The LJLRN, HILRN arguments define the range of LRNs to execute file 
orints and applications in the background. [n the example ahove, two 
LRNs are available which would allow two background file prints, two 
background aoplications, or one of each. 


Specifying the Number of Function Overlays 


The following diractive specifies the number of OVLY directives used 
in linking the DEF-I functions. 
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Directive Comment 


VDEF JLYNU,X%000387 /Number of function overlays = 3 


Specifying the Size of the CRT Screen 


The following directives spacify the dimensions of the screen of the 
Operator display station. Tre forms xrocessor will not permit fields 
on a form to be created outside of the positions specified here. The 
size of the CRT sereen must be specified as follows: 


UVirective Comment 
VJzr CRTC, xX” 00507 7ZCOLS PER CRT LINE X%507%280 
DECIMAL 
VJEPF CRTL,X“ 00177 /LINES PER CRT SAGE X71 77213 
DECIMAL 


Svecifying Continuous or Noncontinuous Keyin 


The following directive specifies whether keyina is continous’ that 
is, wnether the system will tad forward automatically between fields 
or whether the RETJRN key must be entered to reach the next field, 


Directive Conment a 
VISF NCONKN, X707 /X70% MEANS CONTINUOUS, NON X¢02 


MEANS NONCONTINJOUS KEYIN. 


AVICAL Argument 


This argument is required and is reserved for system use? 
VJsr AUTCAL, X% 00004 /RESERVED 


CLM_useR-Related Directives 


The following directives are specified in the CLY_USER file. 
They define the followings 


|. The LRN of the first DEFe-I CRT. The value must match the 
lowest LRN value specified in the CLM_USER file for a Jjevice 
to be used as @n operator display station. In the examole, the 
X7UC90% corresponds to the (decimal) i2 in Figure E=i. 
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Directive Comment 


Vodr CRTLRN,X70C00/ /LRN OF PIRST CRT DRIVER = 12 
DECIMAL 


2. The LRN of the first orinter used by DEF=-I, The value must 
match the lowest LRN value specified in the CLM_USER file for 
a printer to be used with DEr-[. In the examole, the X’0800/ 
corresoonds to the (decimal) 8 {n Figure E-}, 


Directive comment 
YWEr PRTLRN,X% 03007 7LAEN Jr FIRST PRINTSR DRIVER 


3. The oreseace or absense Of an Operator console. A value of 
X700597 (ASCII Y) in the VDEF OPCINS directive indicates that 
a console is present: a value of X“O004E% (ASCII N) inticates 
that there is no console. 


Oirective comment 
YDEF OPCONS, X47 00597 “ASCII, VY, OPERATOR?S CONSOLE 
[S PRESENT 


4. The number of CRT’s available as D&r-[ operator display 
stations. Note that this number nust not excead the number of 
CRT’s soecified in the CLM_USER file. 


Directive Comment 
Vise CRTNO,X% 00047 /NUMZER OF CRT% 3 SUPPORTED 


3. The number of orinters available to DE&r-[. 


Directive Comment 
VOer PRINO,X“%39001¢ “NUMBER Jr PRINTRRS31 
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Printer 


rormatting 


The following directives define the number of characters per line 
and the number of lines per ovage for each printer. Note that 16 
directives must be present, even if only one printer is used. 


Directive 


VDEF 


VOeF 


VDEF 
VDEF 
VDEF 
VDer 
VUEr 
VDEF 
VDEF 


rixed suffer Allocation 


PRTCI xX“ 00887 


PRILI .X7003E/ 


PRTC2 .X7 9088? 
PRTL2,X?7 003E° 
PRTC3 .X7 008387 
PRTL3 ,X% OOIJEY 
PRTC4 ,X°0088/ 
PRTIL4 ,X7003E% 
PRTCS ,X“ 00887 
PRTL5 ,X* OO3E% 


= PRTCS ,x“00884 


PRTL6G »X7 903E¢ 
PRTC7 ,X% 90887 
PRIL7,X7003E° 
PRTC8 ,X? 00384 


= PRTL8,X?003E% 


Comment 


/PRINTER | LINE AIDTH=136 DECIMAL 
characters (Hexadecimal 8&8) 


/PRINTER | LINES/PAGE#42 DECI WAL 
(Hexadecimal 35) 


“PRINTER 2 LINE WIDTH=! 36 
PRINTER 2 LINES/PAGE®62 
/PRINTER 3 LINE WIDTH=1 36 
7PRINTER 3 LINES/PAGE 242 
“PRINTER 4 LINE AIDTH#! 36 
“PRINTER 4 LINES/PAGE=62 
/PRINTER 5 LINE WIDTH=! 36 
/PRINTER 3 LINES/ PAGE 862 
/PRINTER 6 LINE WIDTH=! 346 
“PRINTER 6 LINES/PAUE 262 
‘PRINTER 7 LINE WIDTH=1 36 
“PRINTER 7 LEINES/PAGES62 
PRINTER 8 LINE WIDTH#1 36 
8 


/PRINTER LINES/ PAGE a42 


Each active operator display station (CRT) reauires 4a certain amount 
of workspace. For example, each active CRT requires a constant 
memory storage area of 357 words. The remaining workspace 
requirements depend upon the function executing at the CRT and are 
provided by a set of fixed and dynamic buffers. Dynamic buffers are 
requasted as they are needed from the user pool. Fixed buffers must 
be specified using Linker directives. There are four sizes of J&F=l 
fixed buffers specified using the VDErF directive NBI, NB2, N33, and 
NBS arguments. These buffer sizes are listed in Table F-9. 


Table E=-9, DEF=I[ Fixed Buffer Sizes 


Buffer Length (Words) 
Buffer Argument Decimal 


_ 


NBI $024 . seee 
256 
Configurable 


10 


Buffer arguTent NB4 ts reserved. 


Depending upon the particular aoolication executing at the CRT some 
of the DEF-[ fixed buffers are used only temporarily and are 
returned to the DEF-I fixed buffer pool as soon as their use {s 
completed. The buffers may then be used by some other ooerator 
display station, thus reducing the nunber of buffers that must he 
linked. . , 


Table =-!0 shows the DEF=I[ fixed (F) and dynamic (D) buffer 
requirements for the JsF-!I functions and indicates whether the 
buffers are temporarily held or are held as long as the function is 
beinj used. The figures given are for a jyiven Operator disolay 
station. 


Table E-IO. Fixed and Dynamic Buffer Reaulrements 


NBI NB2 
1024 Wds | 256 Wds sie eats 


L_runction | e# |e of #3 | ions 

DATA ENTRY As many 4s 
needed 

JATA ENTRY WITH AS many as 

TABLES needeJt 

OATA ENTRY WITH As many as | 

PROGRAMS needed 

DATA ENTRY AI TH As Many as 

TABLE 3/7 PROGRAMS needed 

DATA ENTRY ~ As many as 

MOD LF LCATION needed 

JATA As many as 

VERIFICATION needed 
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Table E=10 (Cont). pixed and prngmic putter. eget re mente 


NBI Nu2 NB3 NBS ae | 
1024 Ads_ 256 Wds Configurable 


| FORMS MODIFY | MOD IF Y 


CREATE A VERIFY 
TABL 
CREATE AN 
EXTRACT TABLe 
COPY A FORM 
OR TABLE 


VIEN A FORM 
UR VERIFICATION 
TABLE 


VIEW AN exTRACT 
TASLE 


PILE PRINTING 


As many as 
CFORMATIED) needed 
PRINT A ZORM 
WR TASLE 


[SHIFT #7 PAINT | [SHIFT #7 PAINT | PQINT 


#caiicates that the ae are used bcecdaet fee then released, 


*##eN35 buffers are used for extended field (program calls, 
unoer/lower limits, tables, constants) used on the form. There is 
one NBS required per extended field usej on a form. 


Jeneral rules based uvoon the above table for linkin5 ‘NBI, NB2, N33, 
and N35 size buffers are as follows? 


- fOr Operator display stations used for data entry only use: 
1 NBI per 2 Operator display stations 
2 N32 per overator display station 
3 NB3 per Operator disslay station 
> N35 per operator display station per extended field on form 


» For operator display stations used for development (form 
creation, tables, copies, etc.) 
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2 N31 per Operator disslay station 
| NS2 per operator display station 
|! N33 per Operator dis»lay station 
1 NBS per overator disolay station per extended field‘on form 


NOTE! Attemots to srocess with insufficient buffers Linked produce 
unspecified results. [5 most cases, an INSUFFICIENT USER 
MEMORY message will apoear on line 24 of the operator display 
station. 


Tne followin) directives define the number of buffers allocated for 
each size and the size of buffer 3. Buffer 3 is used for the Jata 
Entry buffer and contains the current data entry record. Therefore, 
the specified size must be the same as the buffer size specified 
when linking any data entry orojrams. Also, the number of data 
characters the buffer will contain is twice the buffer size in words 
less !4 characters for the header. (see the D&r-[ User’s Suide). 


Directive Comment. 
Wir NBI,X700047 /NUMBER OF STZc | BUFFERS=4 
VJer NB2,X%00047 /NUMBER OF SIZE 2 BUFFERS =4 
VJzr NB3,X%700047 /NUMBER OF SIZE 3 BUFFERS =4 
VDEF NB4,X%00907 /NUMBER OF SIZE 4 BUFFEQS=0 
VOSF NBS ,X%00287 /NUMBER UF SIZE 35 BUFFERS=40 

(nexadecinal 23) 

VDEF SB3,X70080/% SIZE OF 3urrFER3 = 128 (Hex 30) 


words2256 chiracters 


Data Entry Program General Purpose Buffer 


The following directive specifies the size of the general ourosose 
buffer, buffer number 6, usad by any data entry program. You must 
specify a buffer size as large as the largest jeneral purvose buffer 
required by any data entry program that will execute on your system, 
The buffer size is svecified in words, half the number of characters 
the buffer will hold. One buffer is used for each operator disolay 
station executing a data entry program. 


Directive Comment 
VDEF DUPWRD,X%00207 “SIZE OF DATA ENTRY PQOGRAM 


“GENERAL PURPOSE SUFFER =32 
/{Rex 20) WORDS = 44 
/CHARAC TERS 
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eirst LRN 


The following directive defines the first LFN to be used by DEF=-I1. 
This aumber affects the value of the maximum LFN argument specified 
in the soawn group command for the task group. In the following 
example, LFNs |! to 8 are available for use by data entry programs. 
Note, however, that the DEr=-I LFNs may also start at !. In that 
case, the orogram LFNs would start following the last DEF=I LFN. 
JEF=-I requires 8 LFNs oer operator display station and 8 LFNs ser 
background area. 


VDer CRTLFN, X% 00097 “FIRST CRT LFN29 


Number Of Background Tasks 


The following directive defines the number of background tasks to be 
run concurrently. It cannot exceed the number of CRT’s nor can it 
exceed the total number of LRNs defined by the LOLRN and HILRN 
arguments. File printing and application programs optionally run in 
the background. File print needs a background task even when the 
print operation is not in the background. At least one hack yround 
task must be specified. 


VDEF BAKNO,X% 0002¢ /NUMBER OF BACXGROUND TASKS#2 


Assigning Volume Name 


Each of the following four directives defines two characters of the 
name of the volume which Di-=-I will initially use for forms, tables, 
and data entry. The hexadecimal values for the anorooriate ASCII 
characters are specified. Orly eight characters are allowed, the 
first must be circumflex (hexadecimal 5E&), the eighth must be 
hexadecimal 3E. Note that the volume assignments can be changed by a 
DEF=I supervisory function, but this link specified volume name must 
be present when DEF~I is loaded. 


Directive Comment ae ; 
VOEF SVNI,X*5E 444 “SYSTEM VOLUME# “9D 
VOEF SVN2,X%% 45467 / afr 
VDEF SVN3,X%757527 vA aw 
VDEF SVN4,X’4B3E7 / =K> 


Specifying Password Parameters 


The following directives define the size and total number of 
passwords available and ome {nitial password used to gatn entry to 
DEF=I[. Note that the {initial password is specified using five 
directives, one for each two characters, even if the password is 
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ee’ 


less than [0O characters long. The excess characters must be 
specified as blanks (hex 20). The directives are only required if 
the Operator security feature is linked. The oasswords may be 
maintained by the oassword update facility. 


Directive Comment 
VWer PASSNO,X%00)0 /NUMBER OF PASSWORD AVAILABLE 216 
(hex 10) 


“MUST BE O IF NO OPERATOR SECURITY 
vVDEr PASSIZ,X”%0004/ /LENGTH OF PASSAORD=4, MAXIMUM 
SIZE IS tO CHARACTERS 


VDEF PASS! ,X7 44457 INITIAL PASSWORD I[S DEF3.2 

VOEr 2PASS2,X% 46337 /(HEX 44, 45, 46, 33, 2E, 32=ASCII 
OEF 3.2) 

VDer PASS3,X%2E3 27 CHEX 26,32*ASCIT.2) 

VDEF PASS4,X%20207 /CHEX 2083LANK) 


VDeF PASS5S,X% 20207 


Specifying Password Accessible runctions 


The following directive specifies the functions which may be 
accessed using the first password snecified above. [If any additional 
passwords are required the initial password must be given access to 
the supervisor function. The functions available are specified hy 
the first 9 cits of the 16 bit, 4 hex character argument, [f the bit 
value for the associated function {s zero, the function is not 
availablei if the bit value its one, the function is available. 

Table z-1! Lists the bits and their associated funetions. Bit 0 is 
the ALgh order bit. 


Table E-!I1. Accessible Function Soecification 


EE - 


Avo lications 
Oata Entry 
Forms 

Pile Print 
(Reserved) 
Supervisor 
Tables 
uttlities 
Verification 


Bit 
f°) 
j 
2 
3 
4 
5 
$ 
7 
3 
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Thus, a directive specifying that all functions are available using 
the first password would be as follows. This directive content is 
recotnended. 


Directive Comment 
Ver PASS&N, X¢FFRFY YALL FUNCTIONS ARE AVAILABLE 


Specifying Allowable QOoerator Functions 


The following directives determine which SEF-I functions can be 
selectad by the operator display station users. If X“%0000% is 
entered for any of these directives, the corresponding DEF=-1 
function cannot be used by any data entry overator. If the function 
is to be allowed, the exadecimal value of the appropriate ASCII 
character must be specified, as illustrated in the example. 


Directive Comment 
VOEr APPL, X%204)1 7 ZATLOA APPLICATIONS#A 
VJer DATA, X%9044% SATLOW DATA ENTRY#D 
WJIZF PORM, X% 00442 /ALLON FORM CREATESF 
Vier INTRA,X“%00907 /RESERVED 
Vier FILPRN, X* 90507 ALLOW FILE PRINT=P 
VJer SUPER ,X% 90537 SALLOA SUPERVISOR FUNCTIONSS 
YOEF TASLE ,x* 0054 /ALLOW TASLES CREATE=T 
Vose UTIL,X% 00557 ZATLOW UTILITIES#d 
Voee VERIF,X?%0056% ALLOW VERIFICATION =V 


Printer 4ssignments 


The followin3 directives determine the initial orinter assignments 
for each CRT. All 20 assignments must be made, even though fewer 
than 20 CRT’s are available. Printer assignments may be temporarily 
changed by a Dér=-I Supervisory Function. 


Jirecti ve Comment 
VOEF PCRTI,X7 90017 /CRT 1 JSES PRINTER 3} 
VoEe ePCRT2,xX“00017 “CRT 2 JSES PRINTER } 
VOEF PCRT3,X%0001% ; /CRT 3 USES PRINTER 1! 
VIJ2F PCRT4,X% 00017 /CRT 4 USES PRINTER } 
VJér PCRTS,x”000!I/" “CRT S&S USES PRINTER ! 
VI2F PCRI6,X700017 /CRT 6 USES PRINTER / 
VOEF PCRT7T,xXx“0001I7 /CRT 7 JSES PRINTER 1 
Voer PCRT3,X°0001¢% /CRT 8 JSES PRINTER 1 
_ WIZE PCRTI,X7 00017 /CRT 9 JSES PRINTER 1 
VISF PCRTIO, xX“ 00017 /CRT 10 USES PRINTER 1 
VJEr PCRTII,X%00017 /CRT t1 USES PRINTER | 
VJzr PCRT12,X%0001% /CRT §2 USES PRINTER I 
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VOEr PCRTI3.X“% 00017 /CRT 13 USES PRINTER 


J 
YJie PCRTI4,X7%00017 /CRT 14 USES PRINTER 1 
VjJae PCRTI5S,X* 00014 /CRT 15 USES PRINTER 3 
VJdr PCRTI6,X% 00017 “CRT 16 USES PRINTER !} 
YVJE=r PCRTI7,X% 000! 7 CRT 17 JSES PRINTER |} 
YDEF PCRTI8, X% 00017 /CRT 18 JSES PRINTER i 
VJde PCRTI9,X700017 “CRT 19 JSES PRINTER | 

| 


VJdF PCRT2O,X% 00017 /CRT 20 USES PRINTER 


Jata Entry overlay Areas 


The following directives define which of the data entry overlay 
areas is to be used by eacn Operator display station for execution 
of overlayed data entry programs, The hexadecinal value is the 
number of the data entry overlay area to be used and must be {In the 
ranzg2 000} through 0004, 
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As with the printer assignmants, the data entry overlay area 
assignments must be made for 20 CRT’s, even though fewer are 
available. Note that these overlays are different from the DEF-[ 
function overlay area. 


Directive Comme nt 
VOer OCRTI ,X“ 90017 “CRT t USES OVERLAY ! 
VJer JCRT2Z,X% 00017 “CRT 2 JSES OVERLAY | 
VIEF OCRT3,X7 0001/7 “CRT 3 USES OVERLAY 1 
VOEF OCRT4,X% 00017 CRT 4 USES OVERLAY 1 
VJerF OCRTS ,X“%90017 CRT 5 USES OVERLAY | 
VIJzF JCRT6 Xx“ 000! CRT A JSES OVERLAY | 
¥Jcr OCRT7,X“0001% “CRT 7 USES OVERLAY 1 
VJcr OCRTS,X“ 00017 CRT 3 YSES OVERLAY } 
VOEF ICRTS ,X“% 00014 /CRT 9 USES OVERLAY } 
VJIEP OCRTIO, X% OOO14 /CRT $10 USES OVERLAY } 
VJEr OCRTI1,X? 00014 /CRT 31 USES OVERLAY 1 
VOEF OCRTI2,X% 00017 CRT 12 JSES OVERLAY 1 
VJEF OCRTI3,X%0901% /CRT 313 JSES OVERLAY | 
Ver JCRTI4, X70001 7 /CRT 14 USES OVERLAY 1 
VUsr JCRTI5, xX“ 00017 CRT 15 JSES OVERLAY | 
Vier JCRTI4,xX“0901% SCRT 16 USES OVERLAY | 
Vier OCRTI7,X*% 00014 “CRT 17 USES OVERLAY 1! 
YJcr JCRTI3,X% 00014 “CRT i8 USES OVERLAY } 
VIEF JCRTI9,X7 00017 “CRT 19 YSES OVERLAY 1 
VJEF WCRT20,X7 00017 “CRT 20 USES OVERLAY | 


comoleting tne Link 


The Link must be completed with the QUIT directive. The MAP 
directive is optional. 


‘AAD 
QJIT 


SROUP SENERATION FOR A DEF=[ SYSTEM 


Use tne 5G (Spawn Group) command to spawn a task group in which 


JEF~-I can Operate. A complete descriotion of the SG command aopears 
in the Commands nanual. 


Task Group Considerations 
Tne task group in which DE--I is to execute requires the following 
specifications for the maximum LRN and LFNt 


LRN - the value must be greater than the maximum LRN used in the 
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START_UP.EC file’s CT (Create Task) commands. 


LFN ~ the value must be aqual to or greater than the result of 
the following algorithm? 


base LFN specified in the Linker VOEF CRILFN directive 


+ 8 x (number of CRT%s) 

+ 8 x (number of bacxground tasks allowed at one time) 

+ | if operator statistics are required 

+ the number Of LFNs required by data entry programs and 


aoolications. 


example Of a Soawn vroup Command 


For examole, a typical JEr-{ SG (Spawn Grous) command might be as 
follows: 


3G AA DLE... 9 ICONSOLE -LRN/28 -LFEN 58 =P 00L AB -WD DEFDIR 
SG 
The spawn group command 
AA 
The id assigned to this task grouo 
2.E.F. 


The userid assigned 


Relative oriority level for this task groun’s lead task 
! CONSOLE 

[nput path for commands and user inout 
“LAN 28 


Highest logical resource number that will be referred to by any 
task in the task jrous 


“Le 38 


4ignest logical file number used by any task in the spawned 
task 3roup 
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=-POUL Ad 


Name of the memory pool from which all dynamic memory required 
by the task grouo is to be taken 


-AJ DEFDIR 
The working directory to be used by the task group. The 
directory used should ave a START_uUP.EC file containing the CT 
(Create Task) command to activate Der-I. 


The LRN in the example is greater than the maximum LRN used in the 
START_UP.EC file’s CT (Create Task) command below. 


The LeN value of 58 is greater than the value determined by the 
following calculations 


LEN = 8x4 (terminals) + 8x2 (hackground tasks) + 9 (base LFN, 
specified in Linker VOEF CRILFN directive) = 57 


DEr _START_UP-Ee FILE (TASK GENERATION) 


Qnee the SG (Spawn Group) command has been executed, several DEr-I[ 
tasks must be created and activated. Appropriate CT (Create Task) 
comnaads may be stored in a START_Ue.EC file imnediately subordinate 
to the initial working directory of the spawned task group or they 
nay be soecified individually at initialization time. START_US.SC 


files are discussed in the System Concept manual. 


Create Task 2 
Tasks are created by CT (Create Task) commands as follows? 
CT ira rel_level ctlwar3 


Irn is the loszical resource number by which the task group 
refers to the task 


rel.level is the priority level of the task 
etliargj is either the control argument 
-EFN root ?symbolic-start-address 
or 
“SHARE Irn symbolicestart-address 
where the -ErN argument includes the name of the bound 
unit root segment (here DEF~I) followed by a auestion 


mark, follawed by the symbolic-start-address (entry point) 
within the root segment, Dér initialization (INFNTR). 
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The -SHARE control arguments specify the additional entry 
points which the DEF bound unit, and the LRN used is that 
associated with tne initialization (INFNTR) entry point. 


RELATIVE LEVSL REQUIREMENTS 


The oT (erzate task} command ortority level requirements for DEr=-I 
tasks are shown in Table E=-1!2. 


Table £-12, DEr=I Relative Priority Level Requirements 


relative 
Level Symbo lic=-Start~-Address 


Description 


OSHTAS 
DBENT 


Wisk Handler 
DO&r buffer Manager 
LOCKS! DEF File Lock Routine 


Ee [nitialtzation/CaT #1 
Control 


INeNTR 


CENTRY Er CRT #2 (and uo) Control 


(none) DEF Background Functions 


Aen | COBMRQ1 if nemory resident 
cCUBOVI Lis ovarlay area | 
COBQV2 Ls overlay area 2 
CUBIV3 is Overlay area 3 


COBOV4 is overlay area 4 


Optional for Data Entry 
Projrams 


In this exantole CENTRY, bacxground tasks, and data entry orograms 
are not given relative level values because one CT (Create Task) 
command ts required oer CRT, background task, and bound unit for 
jata entry srograms. Note that 2a maximum of four Overlay areas and 
Sne weary rest{ient bound unit for data entry srograms may be 
specifies. Note also tnat these are ninimum relative level 
requirements within DEF-I and do not reflect any other LANs within 
the task group. 
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Samole START_UP.EC File 


The commands listed in Figure E=-3 are typical for a DEF=I 
START_JP.EC file. The filename ts “ZSYS71 >DEFDIR>START_UP.EC. 


Chkv >DEFCIR 

CT 5 5 -EFN DEF 7INENTR 
CT | i -SttAre S&S DSHTAS 
CT 2 2 -SHARe 5 DCbENT 
CT 3 3 “SHAR 5 LUCKO! 
CT 6 6 =SHAR: 5 CENTRY 
CT 7 7 “SHARE 5 CENTRY 
CT & & “SHAE 5S CENTRY 
CT 25 25 =SHARE 5 


CT 26 26 SHARE 5 
GT 21 27 eer’ ENTRY 7COBUVI 


ETR 5 
én 


Figure E-3. Sample DEF=<1 START_LUP.ESC File 


In this example, DEre-I has the following: 
eo 4 CRT’s 
© 2 background (file print/apolication) tasks. 
« | data entry orogram overlay area named ENTRY! 


The name of the DEF-I bound unit is DEF. 


(1) 
mn = Last relative level used for CRT 
m- Jumber of backgroud tasks created, 


a 
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SAMPLE SYSTEM FILE STRUCTURE 


Figure 2-4 illustrates the path structure of the DEF=-I related 
systema files, as they are supolied on the release media (the 
directory root name “ZSYS7!1 indicates a mass storage unit). 
Included are the samole CLM_LUSER file, CLM_SAMPLE the samole DEF _I 
linker directive file DEF_SAMPLE.S, IEP_SAMPLE.S, and all DEF-I 
required object units. 


Figure 2-5 {llustrates a typical patn structure of DEF<-I1 related 
systen files once the DEF=-I system has been built. The following 
files have been added to those shown in elgure E4, 


« The CLM¥_LUSER file (for example, the file in Figure S-!). This 
is olaced in the directory SID. 


» The Der=-1 soawn group command contained in an EC file. The file 
is tilustrated in Figure E-4. Note that this ts directly under 
the system root. 


e The Der-I linker directives used to create the bound unit 
called JEF_USERS.S. This file is under the directory ZDRT. 


« The DeF-I bound unit called DEF. 

« The STARTLUJP.EC that creates the VEF=I tasks is in the DEFDIR 
Jirectory. Ain example of the startup file is illustrated in 
Pigure E-3, 

» The bound units for the Der-I data entry programs. 


The user-created DEF-I and date entry orojram hound units and the 
user~crested DEr START_UP.=c are in a user=cresated directory DEFDIR, 


Note that this set of files, naning conventions, and file paths is 
sset as an illustration only. 
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DEF OBJECT 
UNITS 


> ZDFVED.O 
ZDFOVGO 


= ZDFD1.0 OBJECT UNITS 
== 2DFD2.0 agree ENTRY 


DEF_SAMPLE.S 


Figure E~4. Paths of System Files 
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“2SyYSi1 


zoRT oer.ecd DEFOR : 
: Lo zerctio START _uP.ec* 
° ° OF OBJECT 
CLM_USER® . « UNITS EF* 
e e 
ZDFVED.O 
ZDFDVG.O 
zoemAa.o | 
BOUND UNIT 
20F01.0 ace iaidd NTAY1! summa FOR DATA 
ENTAY 
Z0F02.0 ENTRY PROGRAMS 
ZDF03.0 —— 
ZDFD4.0 
DEF_SAMPLE.S 
o€F _usens? 
“Ueor-cregted CLM 
OUser-crested LINKER directives for DEF bound unit 
“DEF bound unit 


SEC file thet spawns DEF group in working directory DEFDIR 
"START—UP.EC file that creates DEF tesks and issues group reedy-on menage 
‘User—crested deta entry program (see the Date Entry Facility User's Guide.) 


Figure &=5. Samole Disk Organization of System and User DEF~I Files 
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&P 
&P 
a? 
$& 
Sw 


WERKE RLEKKEHRRWRERRKEKKRKAKRKRRKEBRAK EEK 
* SAMPLE VEF GROUP GENERKaATItin  ¢ 
AMRRRERARHHRKERKKKKREKRCKEBRKRKRHREES 
A&A DEF. U FSPUSCiNSULE LRN eh oLFR 56 @FIjUL AR er euERDSY 


Figure E=-4. Samoe DEF=I SPAWN GROUP Ec File 


Uoerator Startup Actions 


After all the sreparatory procedures described in this section are 
completed and checked out, a DEF=I system can be started up by 
following a two-step vrocedure. Before oresenting the procedure, the 
files that are required to be on disk are described? 


A CLM_LUSER file soecific to DEF=I under the directory SID 


sound units for the DEz=I system and user data entry programs. 
In the sample disk organization in Figure E-5, they are named 
JEr and ENTRY!. 


A START_UP.EC file in the working directory to create OEF-~I 
tasks and start executing at the proper entry point. 

In figure E-5, the file STARTLUp.Ec ts in sample working 
Jirectory DEFIIR. 


An eC file to spawn a groun for DEF=I[, for examole, DEF.EC in 
rigure E=5. 


The soerator actions are then? 


tl, Bootstrap the system software 
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2. Enter the following command at the ocoerator terminals 
EC DEF 


A task group is created and the command processor loaded. The 
START_JP.EC files are then executed. They create and load the 
tasks Of the DEF-I system, and then start execution of the 
initial DEF-I task, eee in the sample START_UP.EC file 
in Frigure E~3, 


SAMPLE LINKSR DIRECTIVE FILES 


rigure E~7 {fs a listing with sunolied samole argument values, of all 
the Linker directives required to link a DEF-I system, 
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. VOEF CRLRNI,X° 000° 


/ LENKER COMMANDS FOR DEF 3.2 (FOR NON@RESIDENT SYSTEM) 


LIB >ZORT 

LINKN ZDFCTL 
LINKN ZOFIAD 
LINKN ZDFLTO 
LINKN ZOFOSH 
LINKN ZDFBGR 
LINKN ZOFSTA 


~ 


é 

OVLY APOLAY 

BASE $ 

LINKN ZOF AP 

PROT APBASE, APEND 
OVLY OEDLAY 

BASE APEND+x*1° 
LINKN ZDFDE1L 

PROT OEBASE,DEEND 
OVLY FMOLAY 

BASE APENDSX°1° 
LINKN ZOFF Mi 

PROV FMBASE, FMEND 
OVLY FROLAY 

BASE APEND+X°1” 
LINKN ZOFFP 

PROT FPBASE,FPEND 
OVLY SPOLAY 

BASE APEND+xX°1° 
LINKN ZOFSPi.s ZOFPUP, ZOF SP 
PROT SPBASE, SPEND 
OVLY TBOLAY 

BASE APENDOX°1° 
LINKN ZOFTB 

PROT TSGASE, TSEND 
OVLY uTOLAY 

BASE APENDSX°4° 
LINKN ZOFUT 

PRUT UTBASE,UTEND 
OVLY VEOLAY 

BASE DEENDSxX°S0* 
LINKN ZOFVE 

PROT VE84SE, VEENO 


~RNRBPRAASBWARWBANAAASBAABARABRAWARWBWWAA AAA AAR DSS AS 


LIBRARY OF OBJECT MODULES 
DEF SYSTEM ROUTINES 
REQUIRED FOR DEF SYSTEM 
REQUIRED FOR DEF SYSTEM 
OPERATOR SECURITY 
BACKGROUND CONTROL 
OPERATOR STATISTICS 
DEF FUNCTION OVERLAYS 
APPLICATIONS GVERLAY 
STARTS AFTER ENG GF ROOT 
LINK APPLICATIONS es Sar 
PROTECT START/END ADDRESS 
OVERLAY DATA ENTRY 
START AFTER ENO OF APPLICATIONS 
LINK DATA ENTRY 
PROTECT START/END AaDORESS 
FORMS PROCESSOR OVERLAY 
STARTS AFTER END OF APPLICATIONS 
LINK FORMS PROCESSOR a, 
PROTECT START/END ADDRESS 
FILE PRINT PROCESSOR OVERLAY 
STARTS AFTER END OF APPLICATIONS 
LINK FILE PRINT PROCESSOR 
PRUTECT START/END ADDRESS 
SUPERVISOR FUNCTIONS OVERLAY 
STARTS AFTER END OF APPLICATIONS 
/ LINK SUPERVISOR/PWAD UPDATE 
PRUTECT START/END ADDRESS 
TABLES PROCESSOR OVERLAY 
STARTS AFTER END OF APPLICATIONS 
LINK TABLES PROCESSOR 
PROTECT START/END ADDRESS 
UTILITIES PROCESSOR OVERLAY 
STARTS AFTER END OF APPLICATIONS 
LINK UTILITIES PROCESSOR 
PROTECT START/END ADORESS 
VERIFICATION PROCESSOR OVERLAY 
STARTS AFTER OATA ENTRY 
LINK VERIFICATION PROCESSOR 
PROTECT START/END ADORESS ae 


FERERRVEBKEREEKKELELESLERREKCELACKARAKACARKARTAERRARAEKAAERAERRAEREREER 


4 

VOEF OKLRN,X°O100° 
VDEF BMLRN.X°0200° 
VDEF LOKLRN,SX%°O3006° 
VOEF INILRN,X°O500° 
VOEF LOLRN, X°OG19° 
VOEF RILRAN, X°O01A° 


VOEF OVLANI,%°1800° 
VDEF BVLRN2,x°OG00° 
VDEF OVLRN3S,X°9000° 
VOEF OVLANG,X°0000° 


~~ AAA SNS SR SNES 


/ 
VOEF OLYNO,x°8”? 


~. 


DEF SYSTEM LRNS 

LRN OF DISK HANDLER 

LRN OF BUFFER MANAGER 

LRN OF FILE LOCKER 

LRN OF CRT 1 CINITIALIZATIUN LEVEL) 
LOw LRN AVAIL FOR IEF /BACKGROUNOD 
HIGH LRN AVAIL FUR IEF /BACKGROUND 
LRN OF D.E. MEM. RESIDENT PROGRAM OIJRECTOR 
LAN OF DLE. GVERLAY DIRECTUR i 

LAN OF OLE. OVERLAY DIRECTOR 2 

LAN OF OE. OVERLAY GIRECTUR 3 

LRN OF D.E. OVERLAY DIRECTUR 4 


NUMBER OF FUNCTIUNS DVERLAYED 


Figure E=7. Samole DEF-I Linker Directive rile 
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CRIC.X°0050”" / COLS PER CRT LINE 
CRTIL,X 70027" / LINES PER CRT PAGE 
NCONKN, X70" / 0 2 CONTINUOUS, NON 0 2 NON CONTINUOUS KEY. IN 
AUTCAL,X%°0000° / RESERVED 
/ REFERENCES TO LRN°S IN CLM_USER 
CRILRN-X°OC00" / URN OF CRT 2 DRIVER 
PRTLRN,X°0800% 7 URN OF PRINTER 1 ORIVER 
OPCONS,X°59°% / 59 3 OP, CONSOLE, 4E 3 NO UP, CONSOLE 
CRINO,%°09008° / TOTAL NUMBER GF CRTS 
PRTNO,X%°0001° / NUMBER OF PRINTERS CUNFIGURED 
/ PARAMETERS TO DEFINE PRINTERS 
PRIC1,X°0088" / PRINTER 1 LINE WIDTH 
PRTILI,X"OO3E* / PRINTER { LINES PER PAGE 
PRTC2,X%°0088° / PRINTER 2 LINE WIDTH 
PRTL2,X°003E”" / PRINTER 2 LINES PER PAGE 
PRTC3,%°0088° / PRINTER 3 CINE WIDTH 
PRTL3-X°003E° / PRINTER 3 LINES PER PAGE 
PRTCQ,X°0088" / PRINTER 4 LINE WIDTH 
PRTLOsX°005E"% / PRINTER & LINES PER PAGE 
PRTCS-X°0088" / PRINTER S LINE wWIOTH 
PRILS.X°003E" / PRINTER S LINES PER PAGE 
PRTIC6,X%°0088" / PRINTER 6 LINE wIOTH 
PRILOPX°O035E” / PRINTER © LINES PER PAGE 
PRTC7,x%°0088" / PRINTER 7? LINE wilOTeH 
PRILTX°O03E% / PRINTER 7 LINES PER PAGE 
PRTC8.X°0088° / PRINTER 8 LINE WIDTH 
PRTL8,X°005E" / PRINTER 8 LINES PER PAGE 
/ BUFFER ALLOCATIONS 
NB1,X°0000" / NO, OF SIZE { BUFFERS 
NQ2,X%°0000" / NQ,. GF SIZE 2 BUFFERS 
$85,x%°0080° / SIZE OF DATA ENTRY BUFFER 
NB3,X°00090" / NO. OF SIZE 3 BUFFERS 
NB4,xX°0000" 4 NO, OF SIZE 4 SUFFERS 
NBS,»X°0028" / NWO. OF SIZE $ BUFFERS 
DUPWRD,X°0020° / SIZE OF GENERAL PURPUSE BUFFER 
CRTLFN,X°0009°% / FIRST LFN AVAILABLE TO OFF 
BAKNO,X°0002" / NUMBER OF BACKGRUUND FaSKS 
/ OEF SYSTEM VULUME NAME 
SVNL,X°SEGa°? / SYSTEM VOLUME LS te *0 
3VN2,X°A54a6° / &F 
S¥N3,X°S752° / we 
SVN@,X°aB3E’ 4 K> 
/ PARAMETERS TO DEFINE SYSTEM PASSWORDS 
PASSNO,X°0010° / NO, OF PASSWORDS (20 IF NO GPERATOR SECURITY) 
P&ASS1Z-X°0000" ¢ LENGTH GF PASSWORD 
PASS1,x%°4045" / INITIAL PASSWORD = DEF3.2 
PASS2,X%°4633° 
PASS3,X°2E32° 
PASS4,xX°2020" 
PASS5.%°2020° 
PASSFN, X°FFFE* / FUNCTIONS FOR INITIAL PASSWORD 
BIT 0 = AP, BIT 1 2 DE, wll 2 = FM, 
BIT 3 = FP, BIT 4 = (RESERVED), BIT S = 9P, 
BIT 6 = TB, BIT 7 = UT, BIT 8 = VE 


/ FUNCTION LIST (CO = NOT CONFIGURED) 


rigure <=-/7 (vont). 


Sample DEF={ Linker Directive rile 
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VDEF APPL,X°a1° 
VOEF DATA,xX°9a° 
VDEF FORM,X°a6" 
VDEF INTRA, X°00° 
VDOEF FILPRN,X°S0° 
VDEF SUPER,X°S3° 
VDEF_TABLE,X°Sa° 
VDEF UTIL» x°SS° 
VDEF VERIF,x°S6° 

/ 

VDEF PCRT1,X°0001° 
VDEF PCRT2,x°0001" 
VDEF PCRT3,x°0001° 
VDEF PCRT4,x°o00i° 
VOEF PCRTS,x°0001° 
VOEF PERTOG5X%°0001° 
VDEF PCRT7,X°0001° 
VOEF PCRT8,-X°0001" 
VDEF PCRT9,X°0001° 
VOEF PCRTIO,xX°O001" 
VOEF PCRT11,X%°0001° 
VOEF PERTI2,%°0008° 
VOEF PCRT13-X°OO018° 
VDEF PECRTLG,xX°0001° 
VOEF PCRT15-%°0001° 
VDEF PCRT16,X°O0G1° 
VOEF PCRT17,X%°0002° 
VOEF PCRT18,x°0004° 
VOEF PCRT19,x%°0001° 
VOEF PCRT20,x%°0001° 
y ; 
VOEF OCRTIexX°O0G8*° 
VOEF OCRT2,x°0001° 
VDEF OCRT3,X°0001" 
VOEF OGRTA,x%°0001° 
VDEF OCRTS.x“°0002° 
¥DEF OCRT6-X°G001° 
VDEF OCRT7.x%°0001° 
VDEF OCRT8,K°OO08° 
VOEF OCRT9,X°0001° 
VDEF OCRT10.%°G001° 
VOEF OCRT22-X°0001° 
VOEF OCRT12,%°O001° 
VOEF OCRT13,X%°0001° 
VOEF OCRT18,x°0001° 
VOEF QCRT15,%°0001° 
VDEF OCRT16-X*°0001° 
VDEF OCRT27-xX°0001° 
VDEF OCRT18,X°000%° 
VDEF OCRTI9,X%°0001° 
VDEF OCRT2Z0,X°0001° 
MAP 

euIT 


APPLICATIONS 
DATA ENTRY 
FORM CREATION 
RESERVED 
FILE PRINT 
SUPERVISOR 
TABLES 
UTILITIES 
VERIFICATION 
PRINTER ASSIGNMENTS FOR EACH ERT 
PRINTER ASSIGNMENT FOR CRT 
PRINTER ASSIGNMENT FOR CRT 
PRINTER ASSIGNMENT FOR CRT 
PRINTER ASSIGNMENT FOR CRT 
PRINTER ASSIGNMENT FOR CRY 
PRINTER ASSIGNMENT FOR CRT 
PRINTER ASSIGNMENT FUR CRT 
PRINTER ASSIGNMENT FOR CRT 
~PRINTER ASSIGNMENT FOR CRY 
PRINTER ASSIGNMENT FOR CRT 10 
PRINTER ASSIGNMENT FUR CRT 11 
PRINTER ASSIGNMENT FUR CRIT 12 
PRINTER ASSIGNMENT FOR CRT 13 
PRINTER ASSIGNMENT FOR CRT 14 
PRINTER ASSIGNMENT FOR CRT 15 
PRINTER ASSIGNMENT FOR CRT 16 
PRINTER ASSIGNMENT FOR CRT 17 
PRINTER ASSIGNMENT FOR CRT 16 
PRINTER ASSIGNMENT FUR CRT 19 
PRINTER ASSIGNMENT FOR CRT 20 
QVERLAY OLRECTOR ASSIGNMENT PER CRT 
OVERLAY AREA FOR CRT 
OVERLAY AREA FOR CRT 
OVERLAY AREA FOR CRT 
OVERLAY AREA FOR CRT 
OVERLAY AREA FOR CRT 
QVERLAY AREA FOR CrT 
OVERLAY AREA FOR CRT 
OVERLAY AREA FOR CRI 
OVERLAY AREA FOR CRT 
OVERLAY AREA FOR CRT 10 
OVERLAY AREA FOR CRT 11 
OVERLAY AREA FOR CRT le 
OVERLAY AREA FOR CRT 13 
GVERLAY AREA FOR CRT 14 
OVERLAY AREA FOR CRT 15 
OVERLAY AREA FUR CRT 16 
OVERLAY AREA FOR CRT 17 
OVERLAY AREA FOR CRT 18 
OVERLAY AREA FOR CRT 19 
GVERLAY AREA FOR CRY 20 


Oat MS uty 


~S SS SSA N AS ANA HN ARAN A AAA BAWAA AAA AA HA BAAR AAA BAWABA BWANA NA 
Cano suUhy = 


Figure S=7 (Cont). Samole DEF=<I Linker Directive File 


APPENDIX F 
REMOTS BATCH FACILITY/ 46 


cONFIGURATION 


After the GCOS 6 MOD 490 software has heen initially loaded by a 
stage | system startup, you must define a file of input directives, 
called the CLM_USER file, for the Configuration Load Manager (CIM). 
This file will contain the device symbolic names, communications 
arguments, and memory s00l assignments necessary to use SCUS 6 YOO 
400 software on your hardware system. 

Any future changes to the Remote Batch facility configuration are 
made dy editing the CLY_USER directive file to reflect these 
chanjes. 


vonfiguration Jirectives 


To create a Remote Batch Facility with Remote Comouter Interface 
(RCI), you must speclalize your GCOS 4 WO) 490 system software by 
providing the necessary configuration directives, 

NOTeE* Only tnrformation specifically recuired to create an RCI Retote 


Batch Facility is provided. Full deseriptions of configuration 
directives are given {in previous sections of this manual, 


JIRECTIVES APPLICABLE TO Ret 


SYS 49,100,,10,tsa,iro 
The olan argument must he >2. 
suggested values for tsat 
30 for RCI 
Sugjgested values for Irb? 


49 for Rel 


FQ] 


COMM 3 


This directive is used in the normal manners {.e., it must 
precede the LeHn directives and soecify the communications 
interrupt level. Both the communications interrupt level and the 
normal mode level should be the highest priority hardware levels 
in the system to ensure satisfactory Operation. 


Recommended levels are 7 or 8 in the COMM directive and 8 or 9 in 
the seco: argument of all LeHn directives (see below). 


ACU Irn,level ,X’%acu_channel’[,’phone_#i if ,* phone #24 Jl, cece] 


This directive is used in the normal manner to configure the 
optional Auto Call Unit for automatic dialing see section VI. 


MEMPOOL S,,size 


Tne Remote Batch Factlity requires a system memory pool size of 
9200 words. 


For examole, if your configuration requires 5500 words for system 
functions and 9200 words for the Remote Satch racility, you would 
specify: ; 


MEMPOOL S,,14700 


LDBU ZERRST 


You must include this directive in your CLM file if you wish to 
collect seripheral device or memory error statistics. Error logging 
configuration fs fully described elsewhere in this manual, Error 
logging srocedures are described in the Unerator’s Guide. 
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Example of Remote Batch Configuration Directives 


The following directives give configuration information for a Remote 
Batch Facility having four RCI streams. 


MEMPOOL S,, 16000 

MEMPOOL ,AB,* 

COuM 8 

RCI 32,10,X’FCOO” 

DEVICE RCI00,32,!10,xX’FCOOY ,LINE32 
RCI 33,10,X’FC80" 

DEVICE RCIO1,33,10,X“%FC80" ,LINE33 
LOBU ZERRST 


QulT 


NOTE! The bound unit ZQRCI must reside in directory SID of the root 
directory. The LDBU Ze2RST directive allows the user to 
configure error Logging, as described in Anopendix P. Using 
this CLM file, the user may designate his host link by one of 
the following! 


3BT 32 


RBT !LINE32 
RBT >SPD>-LINE32 


INITIALIZATION 


Once configuration is complate, you can execute an RBT in the task 
jroup SH or create your own task grouo. If multiole terminals are 
used, there must be a task group for each terminal. The different 
methods that can be used to create a task group are described below, 
ANhether you use $H Or create your own group, you ust also assign 
devices/files, modify external switches if necessary, and invoke the 
task jroup. 


F=03 


Jsing the $H Task Grous 


To use the CII HONEYWELL BULL $H task group, enter: 
EC GROUPSH(C/R) 


Tne command file creates the task group. 


[nittalizing with the Spawn Grouo Command 


Use the Spawn sroun (SG) command to create your own task grouo in 
which the remote batch terminal can Operate. A complete description 
of the SG command can be found in the Commands manual. 


The following is an example of the Su command used to create an RBT 
task jrou0% 


SG Al SMITH.RBT.OPR 2 CONSOLE =OUT !CONSOLE =POOL AB 
-ND RBTLDIR -LRN 2 : 


3G 
The Spawn Group comand. 
Al 


The id assigned to this task group. 
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SMI TH.92BT.OPR 


The user_id assigned 


Pd 
Relative priority level for this task jroup’ each RBT task group 
you soawn must be assigned a unique priority level. 

ICON SOLE 


[Inout path for commands and user ftinput. 
“OUT !CONSOLE 

Fille that is to receive user Sutput and error output, 
-POOL AB 


Nane of the memory nool from which all dynamic memory required by 
the task group is to be taken. 


“0 Q38T_DIR 


The working directory to be used by the task groun. The directory 
used should have a START_LUP.EC file containing the Feady On (92DN) 
command. This command causes the system to issue a ready message 

when the task grouo has been created. 


“LRN 2 


Two Logical Resource Numbers (LRN) are needed by RBT. This number 
shoult tncrease if there are any Other requirements for this task 
jroup. 


MAKING INITIAL DEVICE ASSISNMENTS 


Qnce the task group has been created, the inout and output files are 
assiyned to devices dy usiny the ASSOCIATE command. The fornat tor 
the conmand is: 


ASS(X lfn sath name (C/R) 
ifn ist 
i ~ {nput file 
2~- print file 
3 = sunch file 


Tne following is an example of the typeins: 
assoc [| 'rcproo 


ASSOC 2 '!LpPToo 
ASSOC 3 IMT?!OO>volofile 
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The first line assigns the input file to card reader CDROO. The 
second line assigns the print file to line printer LPTOO. The third 
line assigns the punch file to magnetic tane unit MT900. Vol and 
file must be given names by which they can be accessed. 


AQIIPYING EXTERNAL SWITCHES 


The external Switch Word (£SW) should he set, if desired. The ESW 
shoulj first he set to all zeros and then the desired hits turned 
an. Tne format for the typein iss 
MSW -ALL OFF =-0ON nanee onl CR) 
MSY = Command to modify ESW 
-ALL UFF = Turn off all ES bits 
-ON = Turn on the following bits 


mn =- The bit (hexadecimal digit) that is 
to be turned on 


The following is a breakdown of the 
hit in the External Switch Word: 


Bit. On Off 

) LEST. NOLIST 

J P INCH NOP UNCY 

2 A JTOCALL NOAUJTOCALL 
3 Reserved for system use 

4 STATS NOSTATS 

5 ASCII CREAD) G3CD 

4 reserved #067 system use 

3 LeN 3 ont ASCII LeN 3 out VBT 
9 

A 

B 

Reserved for system use 


Jefault values can be used for ESW settings: bits 0 and | will be 
set for LIST and PUNCH, The relationshio between ESW settings and 
remote batch disoosition codes is explained in the Remote Batch 


vacility vser’s Guide. Pee 


INVOKING THE RBT TASK GROUP 


To invoke the 88T task group and associate it with a logical stream, 
anter the following command. 


Rade Irntc/R) (Cartridge disk environment) 
or 

“ZSYSiI RSF Iirn(c/R) (Diskette environment) 
or 


a3? device name 


The lron value or device_nane is taken from the configuration 
Jirective in the CLML ash fille. It specifies the logical stream you 
wisn to use. : 


ine system responds withs 


(tz) Anam RBF xnann am/dd/hhmm AA/B3/CO/DDND 
(tz) Aham RB RDY 
(tz) Amam Rde STATION NAME @ 9999 


tg ~ Task group itd. 
hhom = Hours, ainutes 
x - S fer SA* mode, L for LAF mode 
nnn = Software revision number 
AA/3B/CC/9DDDN Data/Tine identification of Rar 
9999 = NPS Station Name for LHDLC only. 


The system {ts now ready to accept commands. 


[nittalizin:y with a Command File 


An alternate mathod of performing initialization {s to build a 
comand file with the system Editor and use the EFC command for 
execution. The following steps are necessary? 


J. Refer to the System Vassayes manual for a deseriotion of the 
Executio.. Commaad (Ec) — the &C comnmand araunents, and to 
the Program Presaration nanual for instructions on the use of 
the < OY. 

An example of a command file to snoawn a task group is? 
$ SP_GRP.EC 1980/06/08 
AN 
SU Al RBT.USER.LOPR 2 ICONSOLE -OUT ! CONSOLE 
“AD RBTLDIR =P 00L AB 
$Q 


To execute this command, you must be operating in the system 
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3. 


task group ($8) and type in: 
EC SPLGRPCC/R) 
The system responds with: 


($S)5G Al RBT.USER.O0PR ... 
($S)RDY t 


You can now either remain in the system default task qrouo or 
change to a new task group by typing: 


C tA) s(C/R) 
Again, it is advisable to turn ready on by typing: 
. RON(C/R) 
The task group ressonds with: 
C(AT)RDY?# 
The second command file, as stated above, oerforms the ASSOC 
and MSY commands and invokes the RBT. An example of this 
conmand fille {iss 
& 2BT.eECc 1980/06/03 
AN 
ASSOC 1.!CORS0 
ASSOC 2 !LPTOO 
ASSOC 3 PUNCH FILE 
MSN -ALL OFF =-0N O1] COptionalst defines default state) 
R8T O03 (Cartridge disk: specify “ZSYSii R8T O3 for diskette) 
&Q 
The tyoein for this file is: 
Ec RBT(C/R) 


The system responds by printing out the commands in the 
commami file, and? . 


(3) hhmm RBT xonn am/dd/ Anima 
(tg) hhmm R8T RDY 


You are now ready to serform remote batch processing. 


If the system is to have multiole terminals, individual 
conmand files can be jenerated for the task groups and they 
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can be grouped into a single conmand file. 
xamp le 


& SPLSRPS.EC 
AN 

CC SP_LSRP 1 
EC SPLORP2 
BS SP_GRP3S 
$Q 


By typing ins 
EC SPLGRPS(C/2) 


you can spawn three task groups with a single command, or, if 
Jestred, you can spawn the task grouos individually. 


APPENDIX G 
FILE TRANSMISSION 


This aopendix described the Minit 6 configuration particulars that 
relate to file transmission in conjunction with the configuration 
infornation already presented in this manual. [n this appendix, 
“TRAN*® is a general term used to denote the various Mini 6 file 
transmission utility designations (TRAN and TRANS). 


LINE PROTOCOL CONFIGURATION 


to eee me 


The VIP 7790 line orotocol {ts utilized in file transmission between 
the Minit 6 and CII HONEYWELL BULL host systems. Through the use of 
the PVE (oolled VIP Emulator) Line protocol handler, the Mini 6 
anoears to the host system as a VIP 7700 terminal. The PVE tis 
confijyured using the PVE dlrective as described tn Section VI of 
this manual. 


The following argument soecifications of the PVE directive must be 
noted in configuring a Mint 6 for file transmission: 


« The 2oll address snoecified in the directive must match that 
configured in the host system for the desired communications 
Line. ; 


e iiqn-speed lines should be configured at the highest priority 
levels (lowest numeric): {1.e., line speeds of 2400 and 9400 
baud could be configurad at priority Levels of 20 and 10, 
respectively, but not 19 and 20. The maximum line speed 
suonorted in the file transmission facility fs 9600 baud, 


» The disk device containing the files to be transmitted or 
received must he configured at a lower ortority level (nisher 
numeric) than the comnunications device. 


« The lrn selected for tne directive is the argument used in the 
TRAN tnvocation for file transmisston (see the avooropriate File 
Transmission manual). [f a DEVICE directive is coupled with a 
PVE directive, a filename may be used in the TRAN invocation as 
an alternative to a numeric Irn. 


In 3a “ini 6 to Mini 4 file transmission configuration, the Mini 4 
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desiynated as the host system (acceptor) is configured with a VIP 
(see Section VI) for the communications line, while the Mini 64 
acting as the remote station (initiator) Is configured with a PVE 
for the same line. Again, the doll addresses must match. 


NOTE: If nonswitched lines are used in Mini 4 to Mini 46 file 
transmission, the system configured with a PVE must have TRAN 
tnvoked first. Tis will insure that polls sent from the host 
system will be answered, 


Mini 5/3SC 278) File Transmission 


The Mini 6 configures 8SC protocol on the desired communications 
line for file transmission with an IBM system. The BSC directive 
must specify EBCDIC (see Section VI, "BSC Directive"). The same 
argument soecifications listed above apply. 


MEMORY SIZE 


The memory reauirements of the TRAN program, as detailed in the 
aopropriate File Transmission manual, must be ineluded to calculate 
the size of the system poll area as described in this manual. This 
is done to meet the requirenent of shareable bound units. 


The memory pool associated with the task group(s) in which TRAN will 
be initiated must meet the size requirements of task group control, 
lead task control block, ECL task, plus the additional work ssaces 
as detailed in the appropriate File Transmission manual. 


NOTecs A task group must be created for each concurrent execution of 


TRAN. The available memory for each grouo wnust, again, meet 
the size requiretents as stated above. 
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APPENDIX H 
2780/3780 AORKSTATION FACILITY CONFIGURATION - 


ror the 2780/3780 Workstation Facility (Nr) to interface effectively 
with the host system, the following Mint 6 configuration environment 
must oe established? 


« Noncommunication directives to define the following 
noncommunications aspects of the system softwares 


System variables 
Characteristics and sizes of memory pools 


Physical and logical characteristics of peripheral devices 
used by the 2780/3730 WF. 


System overlays 


System software extensions 


. Two communications directives used to define the following: 


-_ 


The orfiority level at which the MLCP (Multiline 
Communications rYrocessor) interrupts the central processor 
(COMM communications directive) 


The binary synchronous line protocol handler (8SC 
communications directive), 


Jse (or non-use) of multt-record feature. 


Usajye of both communications and noncommunications directives are 
deser{bedt in detatlis tn this manual. 


“igure 


H=i shows a typical Wini 6 configuration required to execute 


the 2/30 Wr, 


C(t) 


[OR 2780 WF, the multi~odlock-count must be either 2 or 7 to match 
the nost configuration. 


HO} 


(SH)yDEVICE KSROO,0,5,X70050% ,CONSOLE, 140 

(SH)SYS ,,,10,40,40,,E 

(SH) DEVICE RCDO! ,4,9,X71 480° Noncommunications 
(SH)DEVICE LPTOO,5,18,X%1380%,LPTOO 

(#0) DEVICE CDROO,6,19,X% 1300%,CRDOO 

($o) DEVICE DSKOO,7,12,X7 4007 Directive 

(Sd) DEVICE DSKO! ,8,43,X" 480" 

(SHIDEVICE DSKO2.9,14,X% 1200 

(SH)DEVICE DSKO3,10,15,X71280 


(SA) COMM20 
(SH)BSC 22,22,X%FCOO% .2,°,EB,7 communications Directives 


($H)MEMPOIL S,,10000 
($A) MEMPOXOL ,AB,¥ : Noncommunications Directives 


(S4)* 
(SH)QUIT 


rigure H=-1]. Typical Mini 45 Configuration to Execute the 2780 WF 
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APPENDIX J 
HASP WORKSTAT(ON FACILITY CONFIGURATION 


ror the MASP Workstation Facility (We) to effectively interface with 
the nost systen, the following Mini 6 environment must be 
established? 


« NOncommunications diractives to define the following 
1oncommunications aspects of the system softwaret 


- System variables 
- Charactertistics and sizes of memory pools 


- Physical and lozical characteristics of pheripheral devices 
uset hy the HAS? We 


- System software extensions 
e S#0 comnunications directives used to define the followings: 


- The oriority level at which the “LCP (Multiline 
Cammunications Processor) interrupts the central processor 
(COM communications directive). 


- Tne HASP line orotocsl handler (HASeP comnuntcattions 
directive) 


Fizure Jel shows a tyolcal “ini 4 configuration reaulred to execute 
the iASP We. In this example, the Host Link oarameter (=N) could be 
any ane of the following? -N 33, =-N !ASPI, or -N>SPD>HASP!. 


SYS oe,1/9,20,20,E 
DEVICE KS290,9,5.X79500% ,CONSOLE , 140 
DEVICE 20001 ,4,9,%71 4807 


JSVICE ROIO2,5,10,X715007% 
JEVICE #0003.6,11,%7 15807 
JIVICS FLV01 ,3,9,X714807 


JAVICE FCI02,9,10,X%7 15007 

YJIVECE Fcvo3,10,11,X715807 

JeVICe <SROI,11,12,X70530% , TTYO Noncommunications 
Directives 
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DEVICE DSKOO,12,13,X%°04007 
DEVICE DSKOI,13,54,X%0480/ 
VEVICE DSKO2,14,15,X% 12007 


DEVICE DSKO3,15, 16,X7 12807 

DEVICE MT9O0,!16,17,X%7 1600 

DEVICE LPTOO,!7,18,X%%1300% ,.LPTOO 

JEVICE CDROO,!8,19,xXx71300" ,DCROO 

COMM 25 Communications 
Directives 

HASP 33,34,X°FC90/% 

DEVICE HASP, 33,34,X“FCOO’ ,HASPI 

MEMPOQOL S,, 19000 

MeMPOOL ,AB,*® Noncommunications 

QULT Directives 


Figure Jeli. Typical Mini 4 Configuratton to Execute the HASP AF 
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APPENDIX K 
PROGRAMMABLE FACILITY/ 3271 


NOTE? See the 3270 [nteractive Factlity User’s vulde for 

Programmable Facility/3271 EIT Operating instructions. 
After an initial system stactup, invoke the Editor to build: (1) a 
CLMLUSER file used in configuration of the system software that 
suoports the PF/327! and (2) a login terminals file used to describe 
the cnaracteristics of each VIP 7200 terminal used in the dynamic 
login of VIP 7200 terminals. A CII HONEYWELL BULL supplied 
jJeneration srogram (ZF32IN) must then be invoked to butld an 
intialization file. If COBOL crogramming extensions are used in 
conjuaction with PF/3271, the COBOL program must be Linked to a 
spectai interface routine (ZCOBIF). The details of the 
initialization file, CLW_USER file, login terminals file, and COBOL 
interface are describej in this Aopendix . 


CLM JSER FILE. 


The CLU_LJSER file is used to configure GCUS to support the PF/3271, 
The er/3271 is composed of the following two bound units: (1) one 
defining the line protocol handler (LPH) for the host system and (2) 
One to define the apolication oortion of the PF. The line protocol 
handler «aust be loaded at stage 2 system startuo (see "Stage 2 
Systen Startup (I[ntermaditate System Startun)", Section [II). The 
directive that defines (loads) the Line orotocol handler for the 
host system {1s described in Section V of this manual (see H3270 
Directive). - 
Configuration information {denttfying VIP 7200 terminals, on Lines 
serviced by the Asynchronous Terminal Driver (AT), ts supplied 
through wse of ATD directives (See Section V of this manual). When 
the system is rehooted, at stage 2 system startuo from the CLY“_USER 
file, a communications line ts configured for each ATD terminal 
display alus one communications line for the host system. 


CLM_USER FILE EXAMPLE he 


The following 1s a tyoical example of a CLM_USER file used in the 
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generation of the PF/32715 


CLA_USER FILE 


DEVICE 
SYS: 40 
DEVICE 
COMM 7 
DEVICE 
DEVICE 
JEVICE 
DEVICE 
JevIce 
JEVICS 
ATI90 
ATUOI 
ATIO2Z 
ATIO3 
H32 70 
43270 


KSROO,5 ,X70600% , 7 CONSOLE? , 140 
2904 42,20,60,5,E 
LPTOO,30, 10,X% 0680" 


ATDOO, 13,9, X*FF80",VIPOO,80,N 
ATVOI,14,9,X“FE80% ,VIPO1,80,N 
ATIO2,15,9,X”FEO0" ,VIPO2,80,N 
ATOO3 , 16,49,X*FEO0” ,VIPO3,80,N 
BSCO0,12,8,X“FL00" , BSCOO 
BSCOI,12,3,X“F C80" ,BSCO! 
1349,X7FF8O" ,0,9600,% 7200" 
14,9,X FOO" ,0,2600,% 7200" 
15,9 ,X“FEOOY ,9,9600,% 72007 
1649 X“FE00 ,9,9609,% 7200/ 

12 48,X7FCOO” ,0,X740" ,X“60" 
11,8,X7FC80% ,2,X"40% ,xX“60" 


M2 4PO0L 3,, 1 7000 
Meo MPOOL ,AB,* 
MEWPOOL ,AC,® 

Me 4POOL ,LO,* 

Me dPoOOL ,~Li,w 

Me WPOOL »L2* 
M2¥4200L ,L3e 


QJIT 


[In tnis examole of a CLM_USSR FILE, the following is shown? 


« rour 


ATUnn directives have been used causing four 


communications Lines to be configured, one ver VIP 7200 
terminal. 


. A DEVICE directive has been “provided” with each ATDOO 
directive so that each pair contains the same irn, level, and 
channel number. 


NUTE? See "DEVICE Directive", in Section 5 of this manual. 


« Two H3270 directies have been used indicating that the line 
protocol handler (lph) will be loaded once defining two host 
system links. 


« A DEVICE directive has been “paired"® with each H3270 directive 
so that each oair contains the same Irn, level, and channel 
number. 


NOTE 


t See "DEVICE Directive*, Section V of this manual. 


LOGIN TERMINALS FILE 


The login 


terminals file is used to describe the characteritics of 
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dp 


2acn VIP 7200 terminal to be monitored by the Listener (a system 
software comoonent) for access requests issued by the PF/3271. The 
fire i$ created with the Editor and consists oft (1!) varifabdle-lenath 
jw, f= and A=tyoe records and, ootionally. (2) a LOGIN cormand. 


The following is an exanpl2 of Suilding a login terminals file. 


Sxanolez 


3uilding the login terninais file (after initial system startup). 


Sntries comments 


zditdor Commands And 
Jirectives: 


He) command to load the Editor 
A Apoend directive used to enter 


Leain records (comorising the 
terminals file) into the current 


ou ffer 
Lawzin Record Entries: 
243 j~, T= and A-tyoe records comprise 
T Vireo this example of the login terninals 
A A file to be naned "TESMI". In this 
As example, only VIPOO will have access 
AC to host systen Links 8SCO0O!, B8SCO02 and 


SSCO3. The host system links will be 
established throujh issuance of three 
separate login comnands from the 
Operator’s console. 


Editor Command And 


-— eee ee eee ee oe ee eee 


Jirectives 


te Sditor escaoe character 


P erint directive used to disnlay 
contents of the current buffer. 


N JTE24) Acite directive used to write 
contents of the current buffer to 
the login terminals file named 
TERMI 

JUIT vauses the cditor to cease reading 
commands and directives. 


The following example shows three possible login terminal files 
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incorporating login commands. 


Examples 


1, Building the login terminals file (after initial system 


startup). 


Entries 


Editor Commands And 


Jirectives 


ED 
A 


Login Record Entries 


a | 
VIiP0O L HOST) AA 
~mARG !8SCOI Cl 


4c. 


a3 

VIPQO 

A L HOSTI -AA 
“ARG !8SCO] Ci 
8 L HOST2 AB 
“Anu !BSCO2 C2 
© L HOST3 Al 


> » BHO 


24 

A L HOSTI AA 
“ARG !BSCOI Ci 
BL HOST2 AB 
mARS 18SCO02 C2 
C L HoST3 AC 
“ARG !BSCO2 C3 
VIP9O 

VIP 

VIPO2 

VI P03 


> » * 


“4d4eA 


ewe ee ee 


Comments 


Command to load the Editor 


Aopend directive used to enter 
login records (comprising the 
terminals file) into the current 
buffer 


Possibility #1! 

G= and T-type record entries comorise 
this examole of a login terminals 
file. In this example, only VIPOO 

has access to host link BSCOi,. 


Possibility #2 

G-, T= and A-type records comprise 

this examole of a login terminals 

file. In this example, only VIP00 

has access to host links BSCO!, BSCQO2, 

and BSCO3 because the T-record ore= 

cedes the A-records,. 

Note: If multisle T=records precede 
the A=records, only the last 
entered T-record is recognized. 


Possibility #3 

Ge, Ap and T-tyoe records comorise 
this examole of a login terminalis 
file. In this example, all VIPs 
have access to host links BSCOl, 
BSCO2 and BSCO3 because the T= 
records follow the A-records,. 
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Sditor Commands And 


ee ee Se ee oe oe 


Jirectives 


2 pe eee eee eee 


IF Editor escape character 


p Print directive used to display 
contents of the current buffer 


% TERM! Write directive is used to write 
the contents of the current buffer 
(for one of the previous three 
possibilities) to a login terminals 
file named TERM}. 


WIT QUIT directive causes the Editor to 
cease reading directives. 


INITIALIZATION FILE 


The initialization file ts used to define the site-specific 
information used to interface with the PF/327!. A CII HONEYWELL BULL 
sugolied generation program, ZF32IN, is provided to verform the 
followiag? 


« Create the initialization file 
. Update an existing inittalization file’ 


- List (partially or totally) an extsting {nitialization file on 
the Operator’s consola,. 


The yeneration program operates in an interactive mode consisting of 
alternatina questions and resvonses between the generation ocrogram 
and you. Depending on the site-specific information to be {ncluded 
in tne {nittali{zation file, two levels of functionality are provided 
by the generation program. : 


Levei | functionality 


At this level, the generation orogram allows the following 
initialization file/record nanioulation: 


- Inclusion of records defining host system linkages (through use 
Of the HOST directive, described later in this appendix). 


- Jeletion of existing host system records and affiltated device 


assignment records (through use of the DELETE directive, 
described Later in this aopendix}. 
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« Positioning of the initialization file to either receive new 
device assignment records or uodate existing device assignment 
records affiliated with host system records (through use of the — 
POSITION directive, described later in this appendix). 


A 


« Listing, on the oOperator’s console, of all information 
pertaining to either: (1) all records defiuing host system 
linkages or (2) a specific record defining a hast system 
linkage (in both cases, through use of the CURRENT directive, 
described later in this appendix). 


« Soecification of the number of Screen Image Buffers (through 
the BUFrERS directives, described later in this anpendix). 


Directives, which interface with the generation srogram in the 
interactive mode, are used to imolement the oreviously described 
initialization file/record manisulation. Table K=-! shows the level | 
directives which are used to define host system linkages. 


Level 2 Functionality 


At this level, the generation prooram allows the following 
initialization file/record manioulation: 


- Definition of device (address) assignment records (through use 
of the PRINTER, VIRTUAL and SCREEN directives). 


. Usdating or deletion of device (address) assignment records 
(through use of the Y, N and D directives). 


Directives, which interface with the generation program in the 
interactive mode, are used to implement the oreviously described 
tnitialization file/record manisnulation. Table K=2 shows the Level 2 
directives which are used to define or update device (address) 
assignment records. depending on the desired anolication, both Level 
1) and Level 2 directives can be used together. 


In the format descriptions shown in the tables which follow, 


brackets ({ 1) enclose optional arguments and braces ({ }) indicate 
a choice. 
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Table K-11. Level |! Directives 


Veneration Program Level ! Directives/Responses 
Prompts 


ENTER CURRENT FILENAME Enter name of new initialization 
file to be created or existing 
file previously created by pnresent 
generation program, 


name consists of from {1 to 12 aloh= 
numeric characters? the first char- 
acter must be alohabetic or a dollar 
sign ($). 


ENTER CURRENT OR HOST HOST pathaame (block size] 
NITH PATHNAME, BUFFER CURRENT (pathname ] 
JR QUIT BUFFERS nna 

QUIT 


HOST 


If a new oathname is specified, 
entry of this directive creates 

a new host system record in the 
initialization file which defines 
the host system linkage. 


pathname consists of !xy¥xx, 

where xxxx represents a commun~ 
ications device_unit (see "DEVICE 
Directive,” Section V of this 
manual). 


blocksize (nnnn) uses a default 
value of 2900 if not otherwise 
specified. 


{f the host system record already 
exists, you can position, delete 
Or update host system records or 
device (address) assignment 
records (sae POSITION and DELETE 
directives, later in this table). 


If you decide to position records, 
you can then choose to undate 
device (address) assignment rec- 
ords (see PRINTER, VIRTUAL and 
SCREEN directives, Table K=-2, 
later in this appendix). 
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. Table K=i (Cont). Level |! Directives 


veneration Program Level |! Directives/Responses 
Prompts _ a cote ca 


CURRENT ( pathname ) 


If pathname 1s specified, all 
information pertaining to a 
specific record (defined through 
a HOST directive) identifying a 
host system linkage is listed. 


If no pathname is specified, all 
information pertaining to all 
records (defined through several 
HOST directives) Identifying sev- 
eral host system linkages is 
listed. 


pathname consists of !xxxx 
where xxxx reoresents a communica= 
tions device_unit (see "DEVICE 
Directive,” Section V of this 
manual). 


BUFFERS nn 


Enter indicates the number of 
Screen Image Buffers (SI8s). 


nn consists of values from ! to 
99. If the number of SIBs have 
been previously specified, entry 
of nn overlays any previous 
number. 


NOTE: “7COPY’ minimally requires 
two buffers. The number 
of buffers should eaual 
one-half the number of 

screens. 


NOTEt The promot ENTER CURRENT OR 
HOST WITH PATHNAME, BUFFER 
UR QUIT again appears 
following the 3UFFERS 
entry. 


QUIT 


Entry tndicates the initialization 
file will be closed and generation 
orogram ZF32In will be exited. 
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Table K=] (Cont). Level ! Directives 


Generation Program Level | Ofrectives/Responses 
Promots 


DO YOU WISH TO POSITION POSITION 
OR DELETE DELETE 


POSITION 


Entry oositions the {nitialization 
file to receive new device 
(address) assignment records or to 
update existing device (address) 
assignment records. Once the file 
is positioned, entry or updating 
of device assignment records can 
occur following the prompts 

ENTER COMMANO OR QUIT (See 

Table K~2 for details). 


DELETE 


entry deletes a specified (via 

HOST directive) host system record 
and any device (address) assignment 
records affiliated with it. 
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Table Ke2. Level 2 Directives 


Generation Program Level 2 Directives/Responses 
Prompts a onset ee eae 


ENTER COMMAND QR PRINTER dn oathnaeme 
QUIT VIRTUAL dn ocathname 
SCREEN dn Loathname)] (1920) 


PRINTER dn pathname 


Entry indicates a printer device 
(address) assignment. 


dn consists of a valid device 
address selected from Table K=-4, 
later in this aosendix. 


{If the device (address) assignment 
record (affiliated with the par- 
ticular host system record (has 

not been previously defined, a new 
device (address) assignment record 
has been oreviously created, you 
must either update or delete the 
device (address) assignment record, 


NOTE Update and delete functions 
are described later in this 
table. 


pathname consists of !xxxx, 
where xxxx reoresents a standard 
device_unit (see "DEVICE 
Directive,” Table 4=<2 in this 
manual). 


VIRTUAL dn ovathname 


Entry indicates an aoolication pro- 
gram device (address) assignment. 


dn consists of a valid device 
address selected from Table K=4, 
later in this anpendix. If the 
device (address) assignment record 
(affiliated with the particular 
host system record) has not been 
previously defined, a new device 
(address) assignment record will be 
created. Yowever, if the device 
(address) assignment record has 
been oreviously created, you must 
either update or delete the device 
(address) assignment record. 
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Table K=2 (Cont). Level 2 Directives 


r 


seneration Program Level 2 Directives/Responses 
Prompts 


NOTE? Update and delete functions 
are described later in this 
table. 


pathname consists of the pathname 

of the application program accessina 
the virtual device. For a description 
of oatnhnames, see the appropriate 
Operator’s Gutde. 


SCREEN dm (soathname! (1920) 


entry indicates a VIP 7200 terminal 
display unit. 


dn consists of a valid device 
address selected from Table K-4, 
later {fn tnis appendix. [f the 
device (address) assiqnment record 
(affiltated with the particular 
host system record) has not been 
previously defined, @ new device 
(address} assignment record will be 
created. However, if the device 
(address) assignment record has 
Seen previously created, you must 
either uodate or delete the device 
(address) assignment record. 


NOTE? Jpdate and delete functions 
are described later in this 
table. 


Optionals pathname ts the pathname 
of the user’s aoolication orogram. 


NOTE? Level !} directives HOST, 
eURRENT or SUFFERS can be 
entered following the oromot: 
ENTER COMMAND OR QUIT. However, 
the effect will he to terminate 
any other entries, undate any 
device (address) assignment 
records and return to Level !} 
processing (see Table K=-l, 
earlier in this anoendix), 
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. Table K=2 (Cont). Level 2 Directives 


Generation Program Level 2 Directives/Responses 
Prompts 


UPDATE 0% DELETE EXIST- 
ING DEVICE ADDRESS? 
(YES, NO, DELETE) 


YtES] 


Entry indicates device (address) 
assignment record will be updated 
with information previously entered 
through a device (address) assign~ 
ment record. 


N(Q) 
Entry indicates device (address) 
assignment record will not be 

deleted. 


Of ELETE } 


Entry indicates device (address) 
assignment record will be deleted 
(in effect, disassociated from the 
current host system record}. 
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ae 


error Messages 


The following error messages, shown in Table K~-3, are produced by 
the generation orogram,. 


[ILLEGAL PATHNAME 


PATYNAWE MISSING 


INVALID DEVICE 
COMMAND [GNORED 


INVALID PARAM 


NO 40STS CREATED 


Table X-3. Error Messages 


Desertotion 


The pathname used On a CURRENT directive 
could not be located. The following | 
generation proiram oromot {is repeated: 
ENTER CURRENT OR HOST WITH PATHNAME, | 
BUFFER OR QUIT. 


Eithert 

(t) A HOST directive without a 
pathname #as entered, The 
following generation projyram 
oromot is reoeatejs: INTER 
CURRENT OR HOST ALTH 
PATHNAME, SUFFER OR QUIT. 
ure 

(2) A PRINTER or VIRTUAL directive 
without a pathname was entered. 
The following yeneration srojram 
oromot is repeated: ENTER COMMAND) 
OR QUIT. 


PRINTER, VIRTUAL or SCRFEN directive does 
not nave oroper device (address) assignment 
(see Table K-4 for proper device addresses). 
The following yeneration program orompt ts 
repeated: ENTER COWWAND OR QUIT. 


ror the BUFFER directive, nn exceeds two 
digits. The following generation orocgran 
oromat is reoeated: ENTEQ CURRENT OR HOST 
NITH SATHNAME, SUFFER OF QUIT. 


For the HOST directive, nnann (block=size) 
exceeds four diaits. The followi.ig generation 
program prompt is reneatet: ENTER CURRENT 02 
HOST AITH PATHNAME, SUFFER OR QUIT. 


Befor? any host system records were created, 
a CURRENT directive was snecifted without, 
in this case, a required pathname. The 
following generation orogram oromot is 
repeated: ENTE CURRENT OR HOST SITH 
PATHNAME, BUFFER OR QUIT. 
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Table K=-3 (Cont). Error Messages 


Deere a 

ILLEGAL ENTRY 
(CURRENT, HOST, 
BUFFERS, QUIT) 


An invalid entry was made in response to the 
following generation program prompts SNTER 
CURRENT OR HOST WITA PATHNAME., QUEFER OR QUIT. 


Note? The prompt {s repeated. 


ILLESAL ENTRY 
(SCREEN, VIRTUAL, 
PRINTER ,CUQRENT, 
CHOST, 3UPFERS,QUIT) 


An invalid entry was made in response to the 


following generation program promot? ENTER 
COMMAND OR QUIT. 


Note? The orompt is repeated. 


Yevice Addresses 


The following table shows the valid addresses used with the VIRTUAL, 
SCREEN and PRINTER directives (shown in Table K-2). 


Table <-4, Device Addresses 


Device or Addresses 
Control Unit 
Nunbers 


6) 
! 
2 
3 
4 
5 
6 
7 
B 
9 
H 

} 

i 


RAKHRWN—O 
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Table K=4 (Cont). Device Addresses 


Device or Addresses 
Control Unit 
Numbers 


Examples of Inittalizatiton Files 


In Example t!, an initialization file has heen created containing one 
host system record and its associated device (address) assignment 
records? 


Example Is 


RDY t 

ZF 32IN 

3271 [INITIALIZATION PROGRAM 9066 
ENTER CURRENT FILENAME 


TESTFL 

ENTER CURRENT OR HOST WITH PATHNAME, BUFFER OR QUIT 
BUFFERS 06 

ENTER CURRENT OR HOST WITH PATHNAME, BUFFER OR QUIT 
HOST !BSCI 

ENTER COMMAND OR QUIT 
PRINTER Cl! ILpPTo 

ENTER COMMAND OR QUIT 
PRINTER C2 !LPTO2 

ENTER COMMAND OR QUIT 
SCREEN D1, PROG! 

ENTER COMMAND OR QUIT 
SCRFEN D2, PROG! 

ENTER COMMAND OR QUIT 
SCREEN D3, PROG! 

ENTER COMMAND OR QUIT 
VIAQTUAL SA >DONW>PROG! 
ENTER COMMAND OR QUIT 
CURRENT 

CURRENT DEVICE ASSIGNMENTSs 
BUFFER COUNT 06 

NUMBER OF HOSTS 01 

HOST LINK !85C} 
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Example i (Cont): 


BLOCKING 0512 

SCREEN DO! 1920 PROG! 
SCREEN D2 1920 PROGI 
SCREEN D3 1920 PROG! 
VIRTUAL 5A >DONW>PROGI 
PRINTER Cl !tLeTo} 
PRINTER C2 !LPTO2 


ENTER CURRENT OR HOST WITH PATHNAME, BUFFER OR QUIT 
Quit 


In Example 2, an initialization file has been created containing two 
host system records and their associated device (address) assignment 
records: 


Example 2s 


RDY st 

ZF32IN 

3271) INITIALIZATION PROGRAM 9066 
ENTER CURRENT FILENAME 
TESTF | 

ENTER CURRENT OR HOST WITH PATHNAME, BUFFER OR QUIT 
HOST !BSCI 256 

ENTER COMMAND OR QUIT 
PRINTER Cl !LPTOI 
ENTER COMMAND OR QUIT 
PRINTER C2 !LPTO2 
ENTER COMMAND OR QUIT 
SCREEN DI, PROGI 

ENTER COMMAND OR QUIT 
SCREEN D2, PROGI 

ENTER COMMAND OR QUIT 
SCREEN D3, PROG! 

ENTER COMMAND OR QUIT 
VIRTUAL 5A =DONW>PROG! 
CNTER COMMAND OR QUIT 
SUFFERS a9 

ENTER CURRENT OR HOST WITH PATHNAME, BUFFER OR QUIT 
HOST !8S5C2 1024 

ENTER COMMAND OR QUIT 
PRINTER C3 !LPTO3 
ENTER COMMAND OR QUIT 
PRINTER C4 !LPTO4 
ENTER COMMAND OR QUIT 
SCASEN ,.D4,!TTYO4 

ENTER COMMAND OR QUIT 
VIRTUAL 5F >DOWN>PRUG2 
ENTER COMMAND OR QUIT 
CURRENT 
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Example 2 (Cont) 


CJRRENT DEVICE ASSIGNMENTS 
SUFFER COUNT 09. 
NUMBER OF HOST 92 


HOST LINK !8SC} 
BLICKING 0254 

SCRSEN O1 1920 PROG! 
SCREEN D2 1920 PROGI 
SCREEN D3 1920 PROGI 
VIRTUAL 5A >DOWN>PRQ0GI 
PRINTER Cl fLeToOl 
PRINTER C2 !LPTO2 


HOST LINK !8SC2 
BSLICKING 1024 

SCREEN D4 1920 PRQAGI 
VIRTUAL SF >DOWN>PROG2 
RINTER C3 !LPT3 
PRINTER C4 !LPTO4 


ENTER CURRENT JR HOST WITH PATHNAME, BUFFER OR QUIT 
QJIT 
ROY s 


In Example 3, an initialization file (containing the host system 
recorijs created in Exanple 2) {5 nositioned to the second host 
system record and updating and deletion functions are performed on 
existing device (address) assignment records? 


or 


exanple 33 


QOYr 

Ze 32IN 

3271 INITIALIZATION PROGRAM 9066 

ENTE2 CURRENT FILENAME 

THSTFl 

ENTE2 CURQENT OR HOST WITH PATHNAME, SUFFER OR CUIT 
40ST !BSC2 

OO YOU AISH TO POSITION 08 DELETE? 

PISETION 

ENTER COMMAND OR QUIT 

SCREEN or, ! TTYOS,1920 

UPJATE OR DELETE EXISTING DEVICE ADDRESS?¢ YES,NO,DELETE) 
Y=5 

SNTER COMMAND OR QUIT 

PRINTER C4 !ILPTO4 

renee OR DELETE EXISTING DEVICE ADDRESS?(YES,NO,DELETE) 
toy hag bm home 

ENTER COMMAND OR QUIT 

CURRENT 


CURRENT DEVICE ASSIGNMENTS 


BJFrFER COUNT 99 
AJABEQ Or HOSTS 02 
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Example 3 (Cont): 


HJST LINK {BSC} 
BLOCKING 0254 

SCRSEN D! t920 PROG! 
SCREEN D2 1920 PROGI 
SCREEN D3 1920 PROG] 
VIRTUAL 5A >DONW>PROGI 
PRINTER Cl §LPTO! 
PRINTER C2 !LPTO2 


RUST LINK !{BSC2 
BLOCKING 1024 
SCREEN D4 1920 PROG! 
SCREEN 5F° 1920 PROGI 
PRINTER C3 §LPTO3 


ENTER CURRENT OR HOST WITH PATHNAME, BUFFER OR QUIT 
QuIT 
ROY ; —~ 


COBOL Interface Program 


= eee - eee - 


To run a COBOL program on the PF/3271, the COBOL oroqram needs a 
special interface. The object module of the COBOL program must be 
linked with the CII HONEYWELL BULL supplied interface program 
(ZCOBIF). The following is an example of creating such a bound unit? 


LINKER XXXXXX 
- LIB »ZCIRT 
LINKN ZCOBIF, YYYYYY+ MAPs QUIT 


where XXXXXX is the hound unit name assigned by the user and YYYYYY 
fs the name of the COBOL program object file. 


/ 
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APPENDIX L -_ 
LISTENER COMPONENT AND LOGIN CAPABILITY 


INSTALLING A SYSTEM LOGIN CAPABILITY 


The listener component enables access to the system from a 
desiynated set of terminals. It must run as the lead task of task 
group $L, and can be activated using commands in the system 
START_UP.EC file or by entering commands from the operator terminal 
after system startup is comolete and the system is operational. 


fMhen the listener {s active, a user can log in to the system from 
the noncommunications terminals (MDC-connected) or communications 
terminals (MLCP/DLCP=connected) Listed itn a “terminals” file. The 
terminals monitored by listener for a login command cannot be 
directly reserved by system apolications. 


To provide a system with the login capability, make the following 
preparations? 


1, Create the terminals file which describes the login 
characteristics of each terminal to be used for login. This 
file determines in which one of three ways login {5s to he 
achieved. A terminal can (a) require a LOGIN command typetn, 
(b) allow a user to type an abbreviation for the login command 
line, or (¢) be immediately logged in, without a typein, when 
{t is ready or connected. 


2. Allocate memory pools for login by use of the CLM MEMPOOL 
directive, 


Once these preparations are completed, you can activate the listener 
as the lead task group $L. Listener activation is described later in 
this appendix. 


MEMORY POOLS FOR LOGIN TASKS 


Nhen you log in as a primary user at a terminal, a task grouo ts 
Spawned which has that terminal as its user_in and user_out files. 
When you enter a LOGIN command, you may specify the task group 
identification (a two-character grouo id) or accept a default group 
id. For each task group to be spawned by a login command, you nust 
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define a memory pool whose 900l_id is the same as the group_id. The 
first character of a default group_id/pool_id {is an alphabetic 
character that may be specified by the user when the listener is — 
activated. If no character is specified, the letter L becomes the 
first character. The second character is the next unused character 
from the sets O,eeoeY ANd AgecesZe If only defaults are taken, the 
number of default pools must at least equal the number of users who 
may concurrently gain access to the system. This number is specified 
in the Gerecord of the terminals file. You can define pools that are 
completely overlapping by specifying each pool in s separate MEMPOOL 
directive. (This also applies to any other type of memory pool that 
you wish to define). For example, to make avatlable all of the 
nonexclusive pool area for the three users who accept default 
pool_ids, use the following directives: 


MEMPOOL ,LO, * 
MEMPOOL ,LI,* 
MEMPOOL ,L2,* 


Additional examples illustrating the allocation of memory are 
included in the description of the MEMPOOL directive. : —/ 


TERMINALS FILE 


wm ee - 


Listener determines which terminals to monitor for system access 
from information in a terminals file. The pathname of the terminals 
file may be specified in the command that requests the listener 
task, or may be defaulted to >SID>TERMINALS. The file ts created 
with the Editor and consists of variable-length G-,T=, and A-type 
records. Arguments within a record are separated by one or more 
Slank characters. For a terninal to have the direct login 
characteristic, the LOGIN command must be specified in the T-record 
for that terminal. 


For @ terminal to have the option of accepting abbreviations for 
LOGIN commands it requires A=-records with the desired command line 
imaje and the absence of a login line in the Terecord for that nat 
terminal. One or more abbreviations can be specified: The A-records 
following a Terecord are associated only with that terminal. The 
Am-records following the Gerecords sallow all terminals to use those 
abbreviations for command lines. When the same abbreviation is used 
in an A=record following a Gerecord, and in an Amrecord following a 
Terecord, the command line image in the A-record following the 
Terecord is used for the terminal. Tne layout of the records of the 
terminals file 1s shown below, 
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GeRecord (only one per file) 


[AmRecords =~ one or more for all terminals] 

T-Record — for a specified terminal - 
(A=Records —= one or more for the above terminal} 
| T-Record —~ for another specified terminal 


{A>Records == one or more for the above terminal] 


G=-Record [n Login File 


There is one G-record in the login terminals file, in tne format: 
G base-lvl max_user 

base_lvl 
Level, relative to the Lowest numeric (highest priority) level 
not used by the system group, on which the lead task of a group 
soawned by Listener for a terminal is to execute unless a level 
{s specified in the login line. 

maxuser 
Maximum number of concurrent logged-in users allowed on the 
system. This value does not include task grouns created or 
Spawned by commands other than LOGIN, Logins that exceed this 
limit are terminated and the listener tssues the message. 


3915 NUMBSR OF CURRENT USERS EXCEEDS THE MAXIMUM 


T-record In Login File 
There is one T-record in tne terminal login file for each terminal 
on Which a user may log in, in the format? 


T CA) dev_iname [ login_line] 


Specifies that only abbreviated logins will be allowed at this 
terminal. If a user specifies a nonabbreviated login line at 
this terminal, the listener issues the following error message? 


39146 * LOGIN MUST BE BY ABBREVIATION 
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dev uname 


Symbolic device name of the terminal, as specified at 
configuration. 


login line 


The login command line image (including the LOGIN or L 
characters) used instead of a user typein when a terminal is to 
be used for direct login. 


AmRecord In Login File 


An A@record contains an abbreviation character and the associated 

LOGIN command line image that the listener will use when a user 

types in the abbreviation. A variable number of A~records may follow 
the Gerecord and/or any T-record. When a user enters an 

abbreviation, listener scans the Aerecords following the Terecord 

for that terminal and if a match is found, uses that login line for —” 
logging in. If the abbreviation is not found, listener scans the 
Aprecords following the Gerecord for a match, and if a match is 

found, uses that login line for loqging in. If no match is found, 

the listener issues the message! 


390E ABBREVIATION FOR TERMINAL NOT FOUND 
The format for the A=-record ist 
: A abbrev login_line 
abbrev 


A lecharacter abbreviation that a user can optionally type in 
when logging in on this terminal. 


login_line 


The LOGIN command line image associated with the abbreviation. a 


LOGIN COMMAND 


The abbreviated description of the LOGIN command that follows shows 
the type of entries that may be included in the A= and Terecords of 
the terminals file. For a detailed description of the LOGIN command, 
see the Commands manual. Note that the length of the login command 
line is Limited to 110 characters. 


The LUGIN command causes (1) a task group associated with the user’s 
terminal to be spawned, or, (2) the terminal to be attached to an 
existing task grous as a secondary terminal. Once he has access to 
the system, the user cannot again invoke login unless he first uses 
the BYE command: or the task group is otherwise terminated. 
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FORMATS 
L loginiid {destination_id] {ctl arg] 


ARGUMENT DESCRIPTION? 
login_id 


Establishes the identity of the user who is attempting to gain 
access to the system. Provides the user identification for the 
spawned task group. The login.id argument consists of from one to 
three fields naving the following meanings? 


person 
person.account 
person.account.mode 
person 
Name Of person who may access systemt can be from ! through 
12 characters. (for example, WOSMITH could be the value 
for the person field). 


account 


Name of an account under which the user is to work! can be 


from ! through. 12 characters. (For examole, JSINVENTORY 
could be used as the.value for the account field). 


mode 


Provides a further {dentification of the usert can be from 
1 through 3 characters. (For example, VER could be used as 
the value for this field). 


(destinattion_id] 


Qotional argument that permits the user to log in as a sacondary 
user Of an existing task group. (A request for a secondary user 
terminal must have been soreviously issued by that task group). To 
log in as a secondary user of a user-created applications 
program, enter the value id, where id {s the task group id of the 
task group in which the application ts running. If this argument 
1s specified, no other control arguments may be specified. 
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Cetliarg) 


None or any number of the following control arguments can be 
selected: 


-PQ jx * (level) 
path id 


Used to override the default lead task, group id/nool id, and 
relative level specifications for the task groun spawned as 4 
result of this login srocedure. 


path 


Patnname of the bound unit to be executed as the lead task of 
the spawned task group. If the star character (*) is entered 
the lead task is the command processor. 


id 


Group_id/oool of the spawned task. The group_id and the ~~ 
pool_id are represented by the same 2-character value. If 


this argument is not specified, a default id is assigned as 
for memory pools. 


Default: The group id is a-2-character value whose first 
character was specified when the listener component 
was activated and whose second character is the next 
unused character in the sequence O through 9 and A 
through Z, assigned by the system. 


level 


Base priority level at which the spawned group is to execute 
(relative to the system group level). A base level of O is 
the next higher level. The sum of the highest system 
physical level plus I, and the base level of the group, and 
the relative level of a task within that group, must not 
exceed 62 (decimal). 


Default’ The base priority level is that specified in the 
terminals file, relative to the system group level. 


“HD path 


Used to specify the home directory for the task group spawned 
as a result of the login procedure. The home directory is 
your initial working directory when you log in under an 
account. 


path 


Pathname of the initial working directory for the spawned 

task group. You must specify a full or relative pathname 

(not a simple pathname). If this argument is omitted, the 
working directory pathname is null. 
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-LRN n 


Jsed to override the default maximum logical resource number 
(L2N) value for the task group spawned as a result of this login 
procedure. 


n 


Maximum LRN value to be used for the spawned task groun. (Tha 
maximum possible LRN value {s 252). If this argument tis 
omitted, the maximum LRN value is I. 


=~LFN n 


Used to override the default Logical file number (LFN) value for 
the task group spawned as a result of this login procedure. 


nf 


Maximum LFN value to be used for the spawned task groun. (The 
maximum possible LFN value is 255). If this argument is 
onitted, the maximum value is 1{5. 


=hOLD 


Set the current connect/disconnect device—specific word to 
specify that the terminal its to be disconnected without phone 
hangup. This argument allows you to reuse the terminal without 
redialing after logging off the system. (See the set terminal 
characteristics (STTY) command or directive for information about 
the connect/disconnect device=specific word). 


Default: The terminal will be disconnected according to the 
setting of the current connect/disconnect 
device~spec{fic word. 


“ARG arg arg . e - arg 


Jsed to pass additional arguments to the lead task of the task 
group spawned as a result of this login procedure. 


LISTENER ACTIVATION 


Listener is activated with the CG (create group) and EGR (enter 
group request) Operator commands, or with an SG (spawn group) 
operator command, using the arguments shown below. These commands 
and their arguments are deseribed in the Commands manual. 


Qnce activated listener can be terminated only if the system shuts 
down, or by using the ~QT argument of the SET_LISTEN operator 
command. Once terminated, the $L task group can he recreated 4s 
described below. 
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CG SL base lvl ~EFN LISTENER -POLL id 


“path wf 
EGR $L user_id *QUT !CONSOLE <ARG Jupath es {X} (*message*} 
SG SL userid base_lvl -EFN LISTENER -PQOOL id 


“QUT {CONSOLE = ARG | j*path a“ 
{»path * (X] (*message*] 


{eeethe} 
“path" 
Pathname of the terminals file, which list the terminals on which 


users May log in, and which contains the terminal characteristics 
records, 


The last character in the pathname must be a blank and the entir e 
pathname must be enclosed in either single or double quotes. An ~ 
omitted (default) pathname must be written as a pair of 

enclosing single or double quotes (% 7%) or (" %), and results in 
the default pathname >SID>TERMINALS. 


{x] 


The first character in the 2=-character oool_id and grouo_id when 
default values are used. The second character, from 0 through 9 
or A through Z, is appended when a task group is spawned as a 
result of the LOGIN command. When this argument is omitted, its 
default value is L. 


When a user soecifies a group_id in a LOGIN command or in a login 
line for a Terecord or A-erecord, listener uses that as a group_id 
instead of generating a groun_id. 


[ "message ] 


The message-of-the=-day, enclosed in quotes to provide for 
embedded blanks, which Listener transmits to all terminals for 
disolay. 


Terminal State After Listener is Activated 


When first activated and again when the session terminates, listener 
performs specific operations affecting the state of a terminal. The 
output on the terminal that a user sees and the state of the 
terminal depend on whether {it {1s a nonconmunications or a 
communications terminal, 
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NONCOMMUNICATIONS TERMINAL STATE WITH LISTENER © 


If a terminal is not ready when listener is activated, no initial 
Output messages from listener are displayed when the terminal comes 


on line. 
When listener is activated: 


1. If there are terminals online, ready for direct login, they 
display the messaqe-0f-the-day. A task group is spawned for 
each such terminal £{f the login_line image contained in that 
terminal’s T=record in the terminal login file svectftes 
orimary login. The lead task defined in the login line {s 
executed. The aoplication should display a prompter message to 
the terminal tndicating that {t is ready to acceot inout. 

Ahen the lead task terminates, the néessajye-of-the-day is 
displayed and a task grouo is immediately spawned again. 


If the login line in the terminal’s T-record specifies 
secondary login, the terminal ts jziven to the group named tn 
the destination field, provided that the group has an 
outstanding request for @ secondary terminal. The group 
returns the terminal to listener’s control by executing a 
release terminal macro call. 


2. Terminals that require a user login, disolay the 
message~of=-the-day and the user login oromoter message 
identifying the systam and giving tne date and times 


LOGIN system td yyyy/tmm/dd/ }Ahmmsss,t 


The user can then type in the LOGIN command. When the lead 
task terminates, the message-of<the-day is displayed followed 
by the login promoter message, 


COMAJNICATIONS TERMINAL STATE WITH LISTENER 


4lthough a communications terminal may not be ready when the 
listener is activated, listener displays a message when the terminal 
comes Online. Otherwise, when Listener is activated, the same 
operations are done for communications terminals as for 
noncotmunications terminals described above, 


When a terminal is released? 


1. A terminal connected by phone and with the hangup option, {s 
disconnected. The user must dial in again to use the terminal. 


2. A terminal connected through a modem bypass or by ohone 
without the hangup option, displays the message-of=the-day +} 
either the login promoter message its disnlayed or, for a 
direct lagin, a login task group is spawned. 
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CHANGING THE LOGIN MESSAGE OF THE DAY 
~~ 


After listener is activated, it places an Operator response request 
to tne Operator terminal. The request number must be used in the 
response to listener from the Operator terminal that changes the 
messayemof=—tne-day. The message to the listener cannot exceed 63 
characters and is in the form: 


AMSG._NOA message-of-the-day 


EXAMPLES OF LISTENER OPERATIUN 


For these exam les, the CLM file includes the following directives: 
DeEVvIce KSROI, 11,21 ,X70380% ,KSRO} - 
DEVICE KSRO2,12,22,X“0600% ,KSRO2 . ~ 
ME MP OOL S.-! 0000 
MEMPOOL 4LO,® 
MEMPOOL ,LI,* 

MEMPQOOL ,MI,* 
MEMPOOL ,AB,L® 


Note that memory pools LO, LI, Ml. and AB all share the same memory. 


Example 13 


The terminals file for this example nas the pathname “ZSYSS51>TERM>T' 
and contains the following records: 


at 
G ] 3 
T KSROt 
A X L XXX 
A YL Y.Y.Y =PO * MI -HD “ZSYS5!1?SYSLIB2 -LRN 40 =LFN 20 
T KS&02 
A wWHL W.A.A 
The iistener is activated by command i made through the operator 
terminal. Commands 2,3, and 4 {illustrate alternative logins made 
through terminal KSRO!]. Note that they cannot be executed in 
sequence unless each is terminated with a BYE command. 
~/ 
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Command ft 


4$S SO $L A 10 ~EFN LISTENER =POOL AB -OUT !CONSOLE 


Command 2% 
AX 
Command 33% 
AY 
Command 48 


An 


“ARG “*ZSYSSL>TERM>TIA ¢ 


The Operations that result from each command are as follows: 


Command is 


Command 2e 


Command 3: 


Command 43 


Spawns group SL with a user_id of A, a relative level 
of 10, bound unit of listener as the lead task, uses 
memory pool AB, the inipath and out_path is the 
console and argument passed to listener is the 
location of the terminals file. The character used for 
default value of the first character of poollia and 
group_id was not given and this defaults to L. 


Listener spawns group ©O with a user_id of X.X.X., 
lead task of command processor. The command processor 
issues the massaget 170222 (No Working Directory) 


‘because ~HD option was not used. User may continue 


after typing in a CWD command. 

Spawns group Ml with a working directoryy of 
“ZSYSS!1>SYSLIB2 and the lead task is the command 
processor, . 

Because the A record is under the T record for KS202 
and not under the G record or the T record for KSROl, 
the listener Lssues the message. 

390E ASBREVIATION FOR TERMINAL NOT FOUND 


For a valid login, the A must be typed in on KSRO2, 


L~tl 


Example 2? 
ia aaa aaa ~—/ 


The terminals file for this example has the pathname “ZSYS5/]>TERM>T2 
and contains the following records? 


G. -P wo 


A Z L Z.Z-Z ~P0 >SYSLIB2>PR MI -HD “ZSYS51>SYSLIB2 
“ARG >SUD>CLM_LUSER =SP | 


T KSROt 
T KSRO2] 
The Listener is activated by command | made through the operator 
terminal. Command 2 is a login made through terminal KSROI. 
Command is 
48S 3G SL B tO -EFN LISTENER =POOL LO “OUT !CONSOLE 
wARG %°*ZSYSSI>TERM>T24 7 
Command 2% 
AZ 
The operations that result from each command are as follows: 
Command i Spawns group SL with a user_id of 38, a relative level of 
10, bound unit of listener as the lead task uses memory 
pool LOs the argument passed to listener is the location 
of the terminals file. The first chatacter of pool_id and 
groupiid was not specified and defaults to L. 
Command 2% Spawns jgreuo Mi which prints CLM_USER and then 
terminates, 


Examole 38 


The terminals file for this example has the pathname “ZSYS51>TERN>T3 
and contains the following records: 


G j 2 
T  KSRO!I L AsACA 


Tne listener is activated by the following command which is made 
through the operator terminal. 


483 SG $L C 10 -EFN LISTENER =POOL MI =OUT !CONSOLE 
~ARG ““ZSYS5SI>TERM>T337% M 


L=-12 


This is an example of direct login. The login command is specified 
“ in the T record. The spawn group command, typed on the Operator 
terminal, spawns listener gepup SL which uses memory pool MI. 
Listener then spawns group Mi with the command processor as the lead 
task, “l as its memory socol, and KSRO! as user_lin and user_out. 


Tne functionality of this ssawn group command can also he achieved 
by the joint use of the create group and the enter grouo request 
commands as shown below. : 

CG SL $0 -EFN LISTENER =POOL M1 

EGR SL C “QUT ICONSOLE ~ARG ?*ZSYS51>TER'Y>T34" M 
A message enclosed in quotation marks may be added to the entries 


following ~ARG. This message will appear on the terminal when the 
group is activated. 
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APPENDIX M 
M4_SYSDEF CHECKLIST 


This aopendix is included as a conventence for users of the 
M4_SYSDEF utility. You can use the checklist provided to write down 
information which the utility requires to generate your directive 
file. The information you write down on the checklist will be 
requested by the utility in the same order. 


Note that this checklist does not include all the questions which 
the utility asks. For examole, it doesn’t List whether VIP devices 
Support form feed. Also, the number of spaces orovided for writing 
information about peripheral devices tsn’t meant to imoly any limits 
on how many devices of a given type you can include in your 
configuration. 
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M4_SYSDEF CHECKLIST 


sigh 
[TEM (Options/ Units) 
1) Total amount of physical memory Pea eae) (Cnnnk ) 
2) Default peripheral channel numbers? (YES/NO) 
(If YES, ignore “Channel! Number* 
entries for noncommunications 
devices) 
3) Commercial system (Model 47/57)? pa ee ee (YES/NO} 
4) (If NO to #3)%8 Simulator? ———— (YES/NO) 
5) Selentifie processor? qureenees (YES/NO) 
6) (If NO #5) Simulator? eae (YES/NO) 
7) System identification message? a 
(Default: “SCOS 6/40D400")} 
8) Installation identification: 
(defaults "YOUR TOWN, USA") 
9) Maximum number of concurrent users? 
10) Default SPD names? See eer (YES/NO) 
(If YES, ignore “SPD name” column 
of subsequent entries) 
11) Record locking? et (YES/NO) 
12) Display Formattind and Control ee (YES/NO) 
350 f tware? 
13) Power fail restart? sceciitataiy CYES/NO) 
14) Communications devices? ———va (YES/NO) 
(If NO, skip items 15 through 23) 
15) Number of conmunications priority ae (! through 4) 
levels: 
16) Number of MLCPs? awewe (1! through 10) 
A 
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17) 


MLCP=connected asynchronous 


SP 
name 


wa 


Channel 
number 


pets hep > a 


A ey eh a eD 


Comm . 
priority 
level 


> ho eS 
ow ee eee 
a oo ee 
6 tee 
[oe ew eww 


epee 


terminals? 


Device 
type 


ore oor ee 


= a = oP 


18) VEP 7700%s or VIP 7800%s to be run in YIP 7790 emulation 


19) 


node & 


Channel 
Number 


ee CD 


ed eS 


Comm. 
priority 
level 


2 a PD > op aD 


13270 Host Links? 


ROP 
ty pe 


a a tn pet 
oe ere 
oe ees oo 
oe ow eo 


eee Sey eee 


SPD 
name 


Channel 
numoer 


eet one ae oe 


Comm. 
priority 
level 


Polling 
address 
(dec. ) 


= apay aor 
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Select 
address 
(dec. ) 


7 eee 
2 copy eee 
=) wD op a ey 
=> epenp on ae Ee 


20) Polled VIP Emulation Groups: 


2!) 


22) 


SPD 
name 


Channel 
number 


oe Oo eo 


Stations/ 
channel 


—— oS oS 
> re 0 eee 


Synchronous Terminalss 


sinary 


Channel 
number 


wa oo 
oe cw cece 
ee Gee oo 


ee ao cE 


VIPs/ 
channel 


em ooo 
wee eee St 
er ee Oe 


oem SmI 


Comn. 


priority 


level 


ee ED oe cee 


> Che ae aap 


Co mn, 
eriority 
level 


Com oS ao oe 


Polling 
address 


wore 


Control 
Stations? 
(YES/NO) 


synchronous communications liness 


Channel 
# number 


> Ww Nw 
] 
i 
d 
| 


Comm. 
priority 
level 


2 wa ee 
> ED OD aE 
PD GE ED 


Primary/ 
secondary ? 
(P/S) 


ee eee See eee 


Sewn oe eee 


ome 


\. 23) MDC~connected console (terminal) devices: 


SPD 
name 


Channel 
number 


Device 
type 


<2 CONSOLE 


24) Diskette devices? 


SPD Channel 
name number 
NH aes 
25) Cartridge disk devices: 
Fixed 
SPD Cnhannel platter? 
name number (YES/NO) 
— _—_ee a See ea eee em aoe epee owe 
26) Cartridge module disk devices: 
SPD Channel 
name number 
ee 
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273 Storage module devices? 


SPD Channel 
name number 


=_Deeck @ seer 


ED te he eS ee 


28) Card reader devices 


SPD Cnannel 
name number 


womamepD ae oe 


29) Card reader/punch or punch devices: 


SPD Channel 
name number 


ware aren oe row 
_os =_ ocr, 
=orurep oo? ee care 


oon Cd 


30) Line printer devices’ 


SPD Channel 
name number 


mace 2D Oo ae 
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3!) Magnetic tape drives! 


SPD Channel 
name number 


—e Siete a 


32) Batch memory pool? CYES/NQ) 
size of batch pool Annan or nnk 
words 
33) Number of 51]2=word system (1 to 10) 


overlay areas (1-99) 
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APPENDIX N 
ERROR LOGGING 


Error logging is an optional feature that allows the system operator 
to collect memory or hardware-related error statistics for selected 
noncommunications peripheral devices. Error logging is intended 
primarily as a preventive maintenance tool, allowing for early 
detection an correction of potential memory or hardware failures. 
The error statistics collected can be used by CII HONEYWELL BULL 
fleld engineering personnel to monitor memory and peripheral device 
performance to determine if corrective actions are required. 


As the system builder, you have the option of configuring error 
logging or not(l). Once configured, the system ooerator must 
activate error logging through commands or macro calls. Error 
logging commands and operating procedures are described in the 
Command manual and the Ooerator’s Guides error logging nacro calls 


are described in the System Service Macro Calls nanual. 


(1) 

The interactive building arogram, M4_SYSDEF, des not allow you to 
configure error logging. You must incorsorate the anpropriate 
software module by hand. 
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CONFIGURATION REQUIREMENTS 


Saat 
Error logging must be incorporated into your configuration before 
memory or device error logging can be activated. The following 
hardware and software requirements are necessary to configure error 
logging for your installation. 


Hardware Requirements 


Error logging requires that you have one or more noncommunications 
devices in your configuration that you wish to monitor. (If you wish 
to log memory errors exclusively, peripheral devices need not be 
attached to the central processor). In addition, cumulative file 
processing (described elsewhere in this appendix) requires that your 
installation has a CIP (or a CIP simulator), 


Nee 
Software Requirements 


To implement error logging, you must load the bound unit ZERRST, 
located in directory SID, using an LDS8U directive. If your working 
directory is SID, include the following directive in your CLM files 


LDBY ZERRST 


Section V of this manual describes the LDBU directive in more 
detail, 


MEMORY REQUIREMENTS 


The error logging facility requires a minimum memory area equivalen— 
to the sum of the following components: 


- 254(16) words (SAF) or 243(16) words (LAF) in the system menory 
pool for the bound unit ZERRST (of which !7(146) words, the 
initialization section, is overwritten after use). 


e 22(616) words (SAF) or 23(16) words (LAF) in the system memory 
pool for each device that is monitored. 


- 39(16) words (SAF or LAF) in the system or user memory coool for 
data for each error logging command. 


» Soace for the bound unit to process a particular error logging 
command. 
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sartale « 


Error logging can be run in the system task grouo ($S) or ina user 
grouo (e.9g., SH). Since the memory area necessary to run the error 
logging bound unit can be quite large, error logging should not be 
executed from the $S group. The operator should {initially create a 
3rouo large enough to acconmodate the error logging session. (If the 
system operator wishes to create and maintain error loaging disk 
files, additional file space is required as well). 
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APPENDIX P 
CONFIGURING DISPLAY FORMATTING AND CONTROL SOFTWARE 


This aopendix describes the requirements for configuring the Oflsolay 
Formatting and Control software. Unless you configure this software 
for your installation, forms processing will not be available to 
users. If your installation uses the Data Entry Facility-II 
(DEF-II), you must configure Display Formatting and Control 
Software. Users should have available for reference the Display 


Formatting and Control manual. 


CONFIGURATION REQUIREMENTS 


The followtng hardware and software reautrements are necessary to 
configure the Display Formatting and Control Software. 


Hardware Requirements 


To performs forms processing, your {nstallation requires one or more 
of the following asynehrnous terminals connected to an MDC or an 
MLCP/DLCP?s VIP 7200, VIP 7205, VIP 7207, VIP 7801, or VIP 7892, and 
a full~duplex modem such as type 103, or One Or more of the 
following synchronous terminals on MLCPs OKU 7007, DKU 7005. 


Seftware Requirements 


~ 


To configure forms processing, you must tnclude the approoriate 
directives in your CLM file as described below. 


CONFIGURATION OLRECTIVES 


The CLM directives required to configure the Display Formatting and 
Control Software depend on whether you wish to configure your 
terminals as noncommunications (MDC=-connected) terminals or 


communications (MLCP=connected) terminals. The directives mentioned 


below are fully described in Sections V and VI. aay 


Configuring Noncommunications Terminals for Forms Processing 


The CLM directives required to configure the Display Formatting and 
Control software with communications (MDC-coOnnected) asynchronous 
terminals are as follows: 


VDAM 


This directive must be specified if the Display formatting and 
Control software is to be incorporated in the configuration. (See 
Section VI fer a full deseriotion of this directive). 


DEVICE CONnn, Irn, level, X%channel’ ,{device_name}, 
(record size], B ‘ “7200 ’ c 
N “D7200" “YT ee 


For each asynchronous terminal capable of running Display 
Formatting Software, you must specify a DEVICE directive with the 
first parameter as CONnmR. The eighth parameter must be specified 
as either "7200" (for VIeP 7290 or VIP 7205 suoport) or "D7200" 
(for VIP 7207 support). The ninth parameter must be specified as 
either C (for CRT visual display mode) or T (for teleprinter 
mode). The terminal runs in the mode you specify whenever it is 
not running in forms mode (i.e., running e forms processing 
software). .Forms mode overrides visual display mode or 
teleprinter mode. 


Configuring Communications Terminals for Forms Processing 


The CLM directives required to configure the Display Formatting and 
Control software with communications (MLCP=econnected) asynchronous — 
terminals are as follows! 


VDAM 


Tnis directive must be specified if the Display Formatting and 
Control software is to be incorporated in the configuration. (See 
Section VI for a complete description of this directive). 


COMM n 


This directive is required for a system that includes 
communications. It must precede all other communications-related 
directives. See Section VI for a descriotion of n, the number of 
interrupt priority levels. 
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LOBU ZOPACT 
LPHDEF 1,96,120 
LPH! lrn, level ,Xx“channel’ ,{modem],speed,FDX, loh=specific-word 


{record_size] ; 
N 


we 


See recoeat sized”, FPBRP ST 
B 


For each asynchronous terminal capable of running Forms 
Processing Software, you must specify an ATD directive and tts 
“paired” DEVICE directive(!). The sixth parameter of the ATD 
directive must be specified as either 7200 (for VIP 7200 or VIP 
7205 support), or F7200 (for VIP 7207 support). VIP terminals 
require a full duplex modem (such as tyne 103) to run forms 
processing. Additionally, the data rate (speed) in bits per 
secon for any asynchronous terminal that will run forms 
processing should be 1 the range of 2400 to 9600, 


For use of the VDAM Block Mode terminal support, you must add 
LDBU Z2NV77F 

and you must describe, through 
STOLN 
‘STO 


POLIST 
. STAPOL 


The configuration of syn¢chronous terminals to be used, the common 
device~type being V7760, both for DKU 7005 and DKY 7907. 


(1) 

Alternatively, you may specify a V7200 directive and its “paired” 
DEVICE directive. However, CIE HONEYWELL BULL recommands using the 
Asynchronous Terminal Device CATD) driver. - 
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CONFIGURATION OPTIONS 


In addition to the configuration requirements deseribed above, you 
have two options to consider when configuring forms processing for 
your iastallation. You may choose to activate the listener 
capability for terminals ia your configuration. You also have the 
option of configuring the operator terminal such that you can 
perform ferms orocessing in a One=terminal configuration. 


Listener performs specific operations affecting the state of a 
terminal. Whether you wish to activate the listener or net depends 
entirely on your installation’s processiny requirements. Refer to 
Appendix L for a comolete description of the listener capability. 


The terminal configured as a standard operator terminal in your 
configuration does not supsort forms processing. If, however, the 
Operator terminal has been configured as a dual-purpose terminal 
that runs alternately under operator control and user control, users 
can utilize the forms orocessing capability when the terminal is 
under user control (i.e., not functioning as an operator console). 
“In this way 1t is possible to run forms processing in a one-terminal 
configuration. Refer to Section V for information on configuring a 
dual-purpose Operator terminal. 
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APPENDIX R 
ASYNCHRONOUS CHARACTER TERMINAL DRIVER (ACTD) 


This appendix provides information necessary to configure a station 
on a line serviced by ACTD (asynchronous character terminal driver) 
through the Communication System, 


DIRECTIVES? 


The Asynchronous Character Terminal Oriver must be loaded and 
{nitialized at CLM time when configuring terminals. as OKU 7002 and 
its auxilary components, DKU 700!, VIP 7200, VIP 7100 or 
teletype-like devices, in the Communications System. 
The configuration directives to he provided ares 
LDBU 
LPHDEF 
LPH? 

which are mandatory 
DEV ICE ; 


Ahich is to be provided only if the associated device is to be 
accessed thru File Management System. 


LOBU Olrective 


The main part of the ACTO handler software (ZQPACT) must be 
explicitly called by an LDOBU directive. 


LOBU ZQPACT 


This directive may be put anywhere in the CLM file. It allows to 
load, residently, in memory the ACTD software. 


RO} 


LPHDer directive 
Tne ACTD iine protocol handler makes use of two channel-tables 
and one station table for each serviced station. The sizes of 
tnese tables must be defined by an LPHDEF directive (involved by 
the further deseribed LPH! directive) 

rormats 


LPHDEF 1,95,120 


Argument Description 
} value led by, the use of the further described directive LPH. 


95 channel=-table size in words (LAF mode) 


120 Station=table size in words. 


Usage conditions 


There must be only one LPHDESF directive regardless of the number of 
serviced station. 


This directive must be below the COMM directive (defining the 
Communication System part of the CLM file) and must precide any LPH! 
directive. 

LPH! directive 


This directive allows to define a station serviced by ACT. 


Format 8 


LPHIl Irn, level ,X’channel’,(modem),speed, 
FDX,loh_speci fic_word 


In this directive name _PH!, | is the reserved value which has 
been associated with the ACID line orotocol handler. 


Argument Description? 


irn 


The logical resource number associated with the station. The value 
for lrn is an integer from 2 through 252. A program may use this 
number to tdentify the station when it requests an input/output 
Operation to the station. 


R=-O2 


NS 


level 


The priority level at which the communications supervisor processes 
requests for an input/output operation to the station. The value for 
Level ts an integer from 7 through 58% it may be the same as the 
Level specified for other communications stations, but it must be a 
higher number than the communications interrupt level(s) specified 
Tn the COMM directive. The level specified for one or more 
communications stations may not also be used for noncommunications 
devices or tasks. 


X“channel? 


A four-digit hexadecimal number (from X“040n’% to X“FF8n~%), 
specifying the channel number of the station and the interrupt 
priority level (nm) of the line. The channel number has the following 
formats 


Bits O through 9 - The i0-bit channel address of the send or 
receive channel on the line. 


Bits 10 through 13 = Must be set to Zero. 

sits 14 and [5 - Soecifies n, the priority level at which a 
communications Line interrupts the central 
processor. nm may have a value of 1,2, or 3 as 
soecifiled in the COMM directive. See the 
desertption of the COUM directive for further 
infornation. 

(modem) 


A number specifying the type of data set, Possible values are as 
follows st 


0 = Direct connect. 

§ = dell lxx=-type modem (103A, II13F, etc.). Both data set-ready and 
carried-detect signals are needed for a connection: absence of — 
both signals is a disconnection. 

2 - Bell 2xx=type modem (201A, 201X, 208A, etc.). The data-set-ready 
Signal is needed for a connection: absence of this signal {ts a 
disconnection. 


3 or greater ~ User-defined modem type (see *"WODEM Directive", Later 
in this section). 


The default vaiue is modem type 2. 
Sp eed 


Tne data rate in bits per second. The default value is zero and 
signifies a synchronous Line. 


R-03 


Por an asynchronous line with a communications—pac whose id is 
2108016), use one of the following values for speed? 


50 300 2400 
75 600 3600 
110 900 4800 
134 1200 7200 
150 1800 9600 


For an asynchronous line with a&@ communicatitons-pac whose id is 
2100014), 2110016), or 2118016), use one of the following values for 
speed. 


50 200 1800 
75 300 2000 
110 600 2400 
134 $050 4800 
150 41200 9600 


NOTe? If the data rate of tre line is 134.5, specify 134. 


PDX 

Specifies that two channel tables wiil be assigned. This parameter 
is mandatory. 

Lphispecificuword 


A word containing information to be passed to the line protocol 
handler through the station table at offset ZOSSTS. 


ane structure of is word is 


L These Aaioe bits ind iwave. the presence Of auxiliary units of 
the device. These bits will be ignored if the device type 
equais Oor |. 

» Bit O indicates the presence of a badge-reader 
- Bit t indicates the presence of an auxiliary printer 
« Btt 2 MBZ 
P Bit of narity specifies the parity to be used. 
0 = odd 


i @ even 


R=04 


S Stop bitespecifies the number of stoo Dits that are to follow 
each character. : 


O = 1 stop bit will be used 
1 = 2 stop bit will be used 
Il DEVICE type-specifies the type of terminal used 
QO = VIP7IOO, teletype like device 
1 = VIP7200, DKU 7001 
3 = DKU 7002 


F Field=-mode specifies whether the terminal will be allowed to be 
connected in field mode or not. 


QO = field mode allowed 
1 = field mode not allowed 
D These five bits specify the number of DEL characters that are 
to follow LF characters in the pre-order ore=space or in the 
oostorder control. . The value chosen may be | up to 32. 
NOTE The support of the badge reader subsystem and the support of 
the printer subsystem are two parts of the ACTD software, each 
part is residently loaded only tf the oresence of the 


corresoondent subsystem has been indicated in one of the LPHI 
directives in the CLM file. 


Usage conditions 


Thera must be as many LPH directives as there area stations serviced 
by ACTOD line protocol handler. 


All these directives must appear after the COMM directive and the 


LPHDEF directive to which they are associated. No others directives 
may de mixed with the set of LPHI directives, , 


DEVICE Directive 
This airective must be used if 
~ efther the driver is accessed by the file System tA TTY mode. 


'- or the device referenced is used like a “secondary” terminal. 


R=O05 


Formats 


DEVICE device_unit,irn,ievel ,X%channel’ ,device_name, 


B 
{record size} ) N 1 


Argument Descriptions 

device unit \ 

A string of five ASCII characters’ the first three must be ATD and 
the last two characters (alohanumeric) identify one specific station 
of that type. Must be in the format ATDnn. 

irn,ievel and X“channel’ 

are previously deseribed 


device_name 


A string of i to 6 ASCII characters, the first of which must be 
alphabetic. This device name {s the unique File System name. 


Record_size 

The length in bytes of one physical record (range) 

B/N 

File System definition of buffered/nonbuffered device. 
B = buffered 


N = nonbuffered 


Usaje conditions 

There must be a DEVICE directive each time a station is serviced by 
ACTD in TTY mode three the file system or each time a station is to 
be logged as a “secondary” station. 


All the DEVICE DIRECTIVES IN A CLM file must appear after the set of 
related LPHI directives. 


R= 06 


COMM 24 
LPHIEF 1,496,120 


* DOKU 7002 with a badge reader 
* (even parity, | stos bit, ! DEL character) 


LPdi 15426,x71C00% ,0,9600,FDX .X793017 


* DOKU 7001 
* (even parity, |! stop bit, 3 DEL characters) 


LP 17427,X7 1C 807 ,0, 9500 ,FOX ,X7 11037 


w ROSY 24 
* (odd parity, 2 stop bits, 4 Del characters) 


LPH! 18,28,X%1D007,1,300,F0X, X”08447 

* VIP 7200 driven by ATD Line protecol handler 
ATD 19,29,X% 1D80%,95600,°7200" 

DEVICE ATDOO, 16, 26, X71C00%, VISU!, 140, N 
DEVICE ATDOO, 17, 27, X71C80", VISU2, 140, N 
DEVICE ATDOO, 18, 28, X71D00%, VISU3, 140, 
DEVICE ATDOO, 19, 29, X*ID8O”, VISU4. 140, N 


LO8U ZQPACT 


R-O7 


INDEX 


2780/3780 AORKSTATION FACILITY CONFIGURATION, H=01 
PRUGRAM MATERIALS (SHC958) (FIG), 7-1] 
TYPICAL MINI 6 CONFIGURATION TO EXECUTE THE 2780 WF (FIG), H=-02 


2780 AF 
‘ TYPICAL MINI 6 CONFIGURATION TO EXECUTE THE 2780 WF (FIG), H=-02 


“ZSY331 : 
TRANSFERRING CONTENTS QF “ZSYS5!1 OR*ZSYS61 TO FIXED PLATTER, 8-02 


“ZSY3S41 
TRANSFERRING CONTENTS OF “ZSYS5! OR ZSYS6!1 To FIXED PLATTER, 8-02 


A 


ACU 
ACU, 5715 
ASSEMSLER/MACRO PREPROCESSOR 
ASSEMBLER/MACRO PREPROCESSOR PROGRAM MATERIALS (SHL937) (FIG) 7-08 


ACTD 


ATO 
‘ATI, 4°15 


BAST 
pera Ser MATERIALS (SHL942) INTERPRETER, INTERPRETER/COMPILER 
F ? a | 
BASIC CLM DIRECTIVES, 5-01 
SUWMARY OF BASIC CLY DIRECTIVES (TBL), 5-02 


BASIC CLM DIRECTIVES 
CLMIN, 5-18 
COMMENT, 5~20 
DEVICE, S-2!° 


4-Ol 


DRIVER, 5-26 
LOBU, 5-29 
MAP, 5-32 
MEMP(OXOL, 540 
QJIT, 5=59 
RESOLA, 5-61 
RLiCK, 5-62 
SYS, 5-65 
VARIABLE, 5-71 


BOOTSTRAP 
BOOTSTRAP OPTIONS (TBL), 3-16 


BOOTSTRAP VOLUME ; 
SOPTWARE TO BE PLACED ON THE B{XITSTRAP VOLUME, 7-02 


3sc 
BSC, 6~22 


3UILDING, SYSTEM 
(SEE SYSTEM BUILDING) 


CHANNEL NUMBERS 
ASSIGNING CHANNEL NUMBERS, 6=07 
DYNAMICALLY ASSIGNED CHANNEL NUMBERS, 6-08 


CHECKPOINT/RESTART 
MEMORY REQUIREMENTS FOR MESSAGE FACILITY AND CHECKPOINT/RESTART 
(TEL), 3-96 


CLM DIRECTIVE FILE 
MODIFYING YOUR CLM DIRECTIVE FILE, 4-04 ‘ 


oLM DIRECTIVES 
BASIC CLM OIRECTIVES, 5-0! 
CL¥ DIRECTIVES AND SUPPORTED COMMUNICATIONS DEVICE (TBL), 6<5 
CLY DIRECTIVES FOR A COMMUNICATIONS CONFIGURATION, 6-01 
FILE SYSTEM PATHNAME IN CLM DIRECTIVES, 5-16 
PORMAT OF CLM DIRECTIVES, 5-03 
RULES FUR ARRANGING CLM DIRECTIVES, 5-03 - 
SUMMARY OF COMMUNICATIONS=RELATED CLM DIRECTIVES (TBL), 6=02 
SUMMARY OF BASIC CLM DIRECTIVES (TBL), 5=—02 


CLM_U3ER FILE 
CLM_USER FILE, £02 
CLYLUSER FILE DIRECTIVES, E~03 
CREATING CLM_USER FILE, #07 
SAMPLE CLM_UJUSER FILE (FIG), E02 
SAMPLE CLMLUSER FILE, E02 


CLMIN 
CLYIN, 5-18" 
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COBOL 
ADVANCED COBOL PROGRAM MATERIALS (SHL945) (FIG), 7-13 
CusuL INTERFACE PROGRAM, K-19 
ENTRY-LEVEL COBOL PROGRAM MATERIALS (SHL9I7) (FIG), 708 
INTERMEDIATE COBOL PROGRAM MATERIALS (SHL925) (FIG), 7-10 


COMM 
COMM, 6=23 


COMMAND 
EXAMPLE OF A SPAWN GROUP COMMAND, E=-27 
LOGIN COMMAND, L=04 
“STTY COMMAND, D=-03 
SYSTEM SEARCH RULES AND THE SYSTEM COMMAND, 8-04 


COMMENT 
COMMENT, 5~20 


COMMUNICATIONS CLM DIRECTIVES 
ACU, 6-15 
ATD, 4-17 
BSC, 4-22 
COMM, 6-25 
DEVICE, 6-27 
EQLRN, 6-35 
A3270, 6~39 
HAS?, 6737 
LPHDEF, 6-45 
LPHN, G=4! . 
MNJEM, 5~47 
POLIST, 4-50 
PVS, 6=5! 
RUP, 6-546 
STAPOL, 6°57 
STATION, 46~58 
STo, 5-59 
STOLN, 6-6} 
“STTY, 6~65 
TIY. 6-73 
VOAM, 6-77 
VROSY, VTTY, and V7200, 4-82 


CONFIGURATION LOAD MANAGER 
CUNPIGURATION LOAD MANAGER ERROR REPORTING, 3-17 
D 


DATA ENTRY FACILITYI 
ACCESSIBLE FUNCTION SPECIFICATION (TBL), E=24 
ACTUAL ARGUMENT, E~t7 


i-03 


ASSIGNING VOLUME NAME, E=23 

BOUND UNIT GRGANIZATION CONSIDERATIONS, E=-08 
CLM JSER~RELATED DIRECTIVES, E~16 

CLMY_USER FILE, E-02 

CLY_USER FILE DIRECTIVES, E=-03 
COMMUNICATIONS SYSTEM DIRECTIVE, E~04 
CUMPLETING THE LINK, E=26 . 

COMPISURATION, E=-O} 

CREATE TASK, E=28 

JATA ENTRY OVERLAY AREAS, E=26 

DATA ENTRY PROGRAM OBJECT UNITS (TBL), E~08 
JATA ENTRY PROGRAM GENERAL PURPOSE BUFFER, E-2! 
DATA ENTRY PROGRAM OBJECT UNITS, E-08 

DATA ENTRY PROGRAMS, E=10 

D&r START_LUP.EC FILE (TASK GENERATION), E=28 
Der SYSTEM OBJECT UNITS, E=06 

USrINING SYSTEM PARAMETERS, E=14 


DEVICE CONFIGURED IN FIGURE E=! OBJECT OIRECTORY PATHNAME (TBL), E~04 


DEVICE DIRECTIVE, E-03 

OQJMMY OSJECT UNIT (TBL), E=+07 

EXAMPLE OF A SPAWN GROUP COMMAND, E=27 

PIRST LRN, F=-22 

FiXSD AND DYNAMIC SUFFER REQUIREMENTS (TBL), E=19 
FIXED BurrER ALLOCATION , E19 

PIXED BUFFER SIZES (TBL), E=I19 

FUNCTION OVERLAY LINKER OLRECTIVES (TBL), E=!13 
FUNCTION RESIDENT/OVERLAY ORGANIZATIONS (FIG), E=-10 
GROUP GENERATION FOR A SYSTEM, E=26 

LINKING, E~05 

LINKING FUNCTION OVERLAY OBJECT UNITS, E=13 

LINKING YVEMORY RESIDENT FUNCTION O8SJECT WITS, E-l2 
LINKING SYSTEM OBJECT UNITS, E=l2 

MEYORY CONSIDERATIONS, Eel! 

MEMORY POOL DIRSCTIVES, 204 

MEMORY QESIDENT OBJECT UNIT LINKER DIRECTIVES (TBL), E=!2 
NUMBER Or BACKGROUN) TAS<S, 2-22 

OBJECT UNITS (TRL), E=04 

OPERATOR STARTJP ACTIONS, E-34 

PRINTER ASSIGNMENTS, E24 

PRINTER FORMATTING, E-t8 

RELATIVE LEVEL REQUIREMENTS, E=29 

RELATIVE PRIORITY LEVEL REQUIREMENTS (TBL)}, E-29 
RESIDENT AND OVERLAYED eUNCTIONS, E99 

SAMPLE CLM_JSER FIL®, E-O2 

SAMPLE DISK ORGANIZATION Of SYSTEM AND USER FILES (FIG), £=33 
SAMPLE LINKER DIRECTIVES FILE (FIGS), E~34, 8-35 
SAMPLE SPAWN GROUP EC FILE (FIG), £=34 

SAMPLE START_JUP.EC FILE, £=39 

SAMPLE SYSTEM FILE STRUCTURE, E=-31 

SAMPLE LINKER DIRECTIVE FILES, E~35 

SPECIFYING ALLOWABLE OPERATOR FUNCTIONS, E-24 
SPECIFYING CONTINUOUS OR NONCONTINUJOUS XEYIN, E=!S 
SPECIFYING LRNS, E=15 

SPECIFYING PASSAORD ACCESSIBLE FUNCTIONS, E=23 
SPECIFYING PASSWORD PARAMETERS, F-22 

SPECIFYING THE NUMBER OF FUNCTION OVERLAYS, E-15 


1-04 
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SYSTEM BOUND UNIT CREATION, E=11 

SYSTEM DEFINITION OLRECTIVE, £-05 

SYSTEM DIRECTORIES, £-05 

SYSTEM OBJECT UNIT LINKER OIRECTIVES (TBL), E=12 
TASK GROUP CONSIDERATIONS, E=26 

TTX DIRECTIVES, &~04 


DEF=I 
(SEE OATA ENTRY FACILITY=1) 


DErF=I 
DEF-II PROGRAM MATERIALS (SHC989) (FIG), 7=!3 


DEVICE 
CLM DIRECTIVES AND SUPPORTED COMMUNICATIONS DEVICE’ (TBL), 4-05 
DEVICE, 5-21, 6=27 
DEVICE ADDRESSES, K=14 
DEVICE ADDRESSES (TBL), <-14 
DEVICE CONFIGURED IN FIGURE E=! OBJECT UNIT DIRECTORY PATHNAME 
(TBL)}, 2-06 
DEVICE DIRECTIVE, E-03 
MAKING INITIAL DEVICE ASSIGNMENTS, F-05 
UNIT VALUES AND DEFAULT RECORD FOR VARIOUS DEVICE (TAL), 3=22 


DISPLAY FORMATTING AND CONTROL SOFTWARE 
CONFIGURATION DIRECTIVES, P91 
CONFIGURATION OPTIONS, P~O4 
CONFIGURATION REQUIREMENTS, P=01 
CONFIGURING, P-Ol 
CONFIGURING COMMUNICATIONS TERMINALS FOR FORMS PROCESSING, P02 
CUNFIGURING NONCOMMUNICATIONS TERMINALS FOR FORMS PROCESSING, P=92 
HARDWARE REQUIREMENTS, 23-01) 
SOFTWARE REQUIREMENTS, P-01 


URIVER 
DRIVER, 5-26 


EDITOR 
USING THE EDITOR, 3-08 


EQLRN 
EQLRN, 6-35 


ERROR LOGGING 
CONFIGURATION, N=-02 
HAIDWARE REQUIREMENTS, N~O2 
MEMORY REQUIREMENTS, N=-02 
SOrTWARE REQUIREMENTS, N-02 


ERROR REPORTING 
CONFIGURATION LOAD MANAGER ERROR REPORTING, 3-17 
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EXEC JTI VE 
MOD 490 EXECUTIVE PROGRAM MATERIALS (FIG), 7~03 


EXTENSIONS, SYSTEM 
(SEE SYSTEM EXTENSIONS) 


FILE 
A-RECORD IN LOGIN FILE, L<-04 
CLM.USER FILE, K-01 
CLYM_LUSER FILE EXAMPLE, K-01 
CSD OPERATOR COMMANDS IN STARTLUP.EC PILE FOR SYSTEM TASK 
SROUP, B=) 
Der START_LUP.EC FILE (TASK GENERATION), E=28 
PILE TRANSMISSION (CIT HONEYWELL BULL HOST) PROGRAM MATERIALS 
(SAC951) CFIG), F=10 - 
PILE TRANSMISSION (NON@CII HONEYWELL BULL HOST) (SHC953) (FIG), 7-09 
PIRMULAS FOR CALCULATING FILE MEMORY SPACE (TBL), 5-54 
G=RECORD IN LOGIN FILE, L=-03 
INITIALIZATION FILE, K=05 
LUGIN TERMINALS FILE, K-02 
SAMPLE LINK=R DIRECTIVE FILE (FIG), E=35, E-36 
SAMPLE SPAWN GROUP EC FILE (FIG), S=34 
SAMPLE START_UP.EC FILE (FIG), F=30 
SAMPLE SYSTEM FILE STRUCTURE, F=31 
TeRECORD IN LOGIN FILE, L=-03 . heieke, 
TERMINALS FILE, L-02 . ue 


FILE SYSTEM 
FILE SYSTEM PATHNAME IN CLM DIRECTIVES, 5=16 


FILE TRANSMISSION 
MINI 6/BSC 2780, G=02 
LINE PROTOCOL CONF ISURATION, G-01 
MEMORY SIZE, G-O2 


FORTRAN 


ADVANCED FORTRAN PROGRAM MATERIALS (SHL944) (FIG), 7-12 
FORTRAN PROGRAM MATERIALS (SHL934) (FIS), 7-09 


Tr 
(SEE FILE TRANSMISSION) 


H3279 ; 
H3270, &=39 


HARDWARE 


HARDWARE REQUIREMENTS, N=02, P-01 
SUPPORTED HARDWARE, C=-03 
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ww 


SUPPORTED HARDWARE = MODEL 23 (TBL), C-03 


HASP 
HASP, 6-37 


MASP AORKSTATION FACILITY 
HASP WORKSTATION FACILITY CONFIGURATION, J=01 
HAS? WORKSTATION FACILITY PROGRAM MATERIALS (SHC959) (FIG), 7=11 
TYPICAL MINI 6 CONFIGURATION TO EXECUTE THE HASP WORKSTATION 
FACILITY (FIG), J-02 


LDBU : 
LIBU ZERRST, F=-02 


LISTENER COMPONENT AND LOGIN CAPABILITY 
A=RECORD IN LOGIN FILE, L=04 
CHANGING THE LOGIN MESSAGE OF THE DAY, L=10 
COMMUNICATIONS TERMINAL STATE WITH LISTENER, L=09 
EXAMPLES OF LISTENER OPERATION, L-i0 
GeRECORD IN LOGIN FILE, L=-03 
INSTALLING A SYSTEW LOGIN CAPABILITY. L=0! 
LISTENER ACTIVATION, L=07 
LOGIN COMMAND, L-04 
MEMORY POOLS FOR LOGIN TASKS, L=0! 
NONCOMMUNICATIONS TERMINAL STATE AITH LISTENER, L-08 
T*RECORD IN LOGIN FILE, ©-03 
TERMINAL STATE AFTER LISTENER I[S ACTIVATED, L-08 
TERMINALS FILE, L~02 


LPHDEr 
LeHDEF, 6-45 


LPHN 
LPHN, 6-41 


M4_SYSDEr 
SXAMPLES OF M4_SYSOEF USAGE, 4-32 
INVOKING M4_SYSDEF, 4~04 
M4_SYSDEF CHECKLIST, M-O1 
M4_SYSDEF OPERATING CONSIDERATIONS, 4=02 
USING M4_SYSDEF, 4-01 
USING M4_SYSDEF IN REBUILD MODE (FIG), 4-47 
USING M4_SYSDEF (FIG), 4=33 
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M4_SYSDEF DIALOG 
Ma_SYSDEF DIALOG, 4-07 ne 
M4_SYSDEF DIALOG IN REBUILD MODE, 4-28 


MAP 
MAP, 5-32 


MEDIA 
MOD 400/MFS PROGRAM MATERIALS AND DISTRIBUTION MEDIA, 7-01 


MEMORY 
COMMUNICATIONS MEMORY REQUIREMENTS (TBL), 6-12 
PORMULAS FOR CALCULATING FILE MEMORY SPACE (TBL), 5-54 
INCREMENTS FOR MEMORY POOLS’ CTBL), 5-4! 
LINKING MEMORY RESIDENT fUNCTION OBJECT UNITS, E=t2 
MEMORY ALLOCATION AND USAGE, 5-07 
MEMORY CONSIDERATIONS, S11 
MEMORY POOL DIRSCTIVES, F=04 
MEMORY POOLS FOR LOSIN TASKS, L=0! 
MEMORY REQUIREMENTS, N-02 
MEMORY REQUIREMENTS FOR MESSAGE FACILITY AND CHECKPOINT/RESTART — 
“(TBL),. 5-56 
MEMORY REQUIREMENTS FOR SYSTEM CONTROL STRUCTJRES (TBL), 5-52 
MEMORY RESIDENT OBJECT UNIT LINKER DIRECTIVES (TBL), E~t2 
MEMORY SIZE, G=02 


MEMORY FRAGMENTATION 
MEMORY FRAGMENTATION, 5-08 


MEMPOOL 
FORMULAS FOR CALCULATING FILS MEMORY SPACE (TBL), 5=50 
INCREMENTS FOR MEMORY POOLS (TBL}, 5-41 
MEMORY REQUIREMENTS FOR MESSAGE FACILITY AND CHECKPOINT/RESTART 
(TBL). 5~56 
MEMORY REQUIREMENTS FOR ELEMENTS IN ONLINE OR BATCH MEMORY POOLS 
(TBL), 3-54 
MEMORY REQUIREMENTS FOR SYSTEM CONTROL STRUCTURES (TBL), 5-52 
REQUIRED FOR SYSTEM COMPONENTS (TBL), 5=44 


MESSAGE FACILITY ees 
MEMORY REQUIREMENTS FOR MESSAGE FACILITY AND CHECKPOINT/ RESTART 
“(TBL), 5-56 


MINIMUM SYSTEM 
MINIMUM SYSTEM FOR ONLINE APPLICATIONS (EXECUTE=ONLY) LAF MODE, C-92 
MINIMUM SYSTEM FOR ONLINE APPLICATIONS (CEXECUTE=ONLY) SAF MODE, C9! 
MINIMUM SYSTEM FOR PROGRAM DEVELOPMENT, C=01 
MINIMUM SYSTEM GUIDELINES, C-01 


MODEL 23 
SUPPORTED HARDWARE = MOOEL 23° (TBL), C=03 


MODE M 
MJIEM, 4-47 


i~08 


OBJECT UNITS 
(SEE DATA ENTRY FACILITY=!) 


OPERATIR C:)MMAND 
CSO OPERATOR COMMAND IN STARTLUP.EC FILE FOR SYSTEM TASK 
GROUP, 3-01 


OPERATOR TERMINAL 
CONFIGURING A DUAL=PURPOSE OPERATOR TERMINAL, S12 
CONFIGURING THE OPERATOR TERMINAL, 5-10 
OPSRQATOR TERMINAL CHARACTERISTICS, 5-10 
SYSTEM CONFIGURED NITHOUT OPERATOR TERMINAL, 5=<15 
SYSTEM STARTUP TYPEOUT AT OPERATOR TERMINAL (FIG), 3-06 


JIVERLAYS, SYSTEM 
(SEE SYSTEM OVERLAYS) 


PERTPHERAL DEVICE 
IDENTIFYING PERIPHERAL DEVICE, 5~19 


POLIST 
POLIST, 4-50 


POWER RESUMPTION 
ACTIONS FOLLOAING POWER RESUMPTION, 9-98 
CONFIGURING POWER RESUMPTION FACILITY, 0-92 
POWER RESUMPTION, 3~O1 
PONSR RESUMPTION CONFIGURATION REQUIREMENTS, 0-02 


PROGRAMMASLE FACILITY/3271 
CLYM_LUSER FILE, K-01 
CLY_LUSER FILE EXAMPLE, <=91 
COBOL INTERFACE PROGRAM, K-13 
DEVICE ADDRESSES, K-14 
VEVICE ADORESSES (TSL), <=14 
ERROR MESSASES (T3L), K-13 
EXAMPLES OF INITIALIZATION FILES, K=15 
INITIALIZATION FILS, K~05 
LEVEL | DIRECTIVES (TBL), K-07 
LEVEL | FUNCTIONALITY, K=05 
LEVEL 2 DIRECTIVES (TBL), K-10 
LeVEl 2 FUNCTIONALITY, <=04 
LOSIN TERMINALS FILE, K~02 
PROGRAM MATERIALS (SHC941) (FIG), 7-12 


PVE 
PVE, 4°51 
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QUIT 
QUIT, 5=59 


RBE/66 
(Sze REMOTE BATCH FACILITY/44) 


RCI 
DIRECTIVES APPLICABLE TU RCI, FO! 
RC1, 6-54 


REBJILD MODE 
M4_SYSDEF DIALOGS IN REBUILD MODE, 4=—28 
RE3JILD MODE DIALOG (TBL), 4=30 
USING M4_SYSDEF IN REBUILD MODE, 4-04 
USING M4_SYSDEP IN REBUILD MONDE, 4<47 


REMOTs BATCH FACILITY/46 
REMITE BATCH FACILITY/445, F-O4 
CONF [SURATION, F-0) 
CONFIGURATION DIRECTIVES, F-0} 
DIRECTIVES APPLICASLE TO RCI, F=O! 
EXA4PLE OF REMOTE BATCH CONFIGURATION DIRECTIVES, F=-03 
INITIALIZATION, F=03 
INVOKING THE R3T TASK GROUP, Fr-07 
LOBU ZEQRST, F=02 
MAKING INITIAL DEVICE ASSIGNMENTS, F=95 
MODIFYING EXTERNAL SWITCHES, F-06 
JSING THE $4 TASK GROUP, F-04 


RESIDENT CODE 
COMMUNICATIONS MEMORY REQJIREMENTS (T3L), 6-12 
REQUIRED FOR SYSTEM COMPUNENTS (TBL), 5246 
REQUIREMENTS FOR COMMUNICATIONS MODULES, 6-11 


RESOLA 
RESOLA, 5-41 


RLOCK 
RLICK, 5-42 


ROP 
ROP, 4734 


RPG 
RPS PROGRAM MATERIALS (SHL926) (FIG), 7-09 
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SEARCH RULES 
SYSTEM SEARCH RULES AND THE SYSTEM COMMAND, 8~04 


SOFTWARE 
PROCEDURE FOR TRANSFERRING SOFTWARE, 8-05 
SOP TWARE REQUIREMENTS, PO! 
SOFTWARE REQUIREMENTS, N-02 
SOFTWARE TO BE PLACED ON THE BIMOTSTRAP VOLUME, 7-02 


SORT/ VERSE a 
SORT/MERGE PROGRAM MATERIALS (SHF910) (FIG), 7=10 


STAPOL 
STAPOL, $=57 


START_UP.EC 
CSD OPERATOR COMMAND IN START_UP.2C FILE FOR SYSTEM TASK 
DEr START_UP.EC FILE (TASK GENERATION), E~28 
SAMPLE START_UP.EC FILE (FIG), E=-30 
SAMPLE START_UP.EC FILE, E=30 


STARTJP 
QPERATORYS STARTUP ACTIONS, 3-14 
OPsRATOR STARTUP ACTIONS, E34 
STAGE 2 STARTUP, 3-08 
STARTUP HALTS, A=0! 
SUMMARY OF STARTUP PROCEDURE, 3-10 


STATION 
STATION, 4-58 


STD 
STI, 6739 


STDLN 
STOLN, 6-41 


STTY 
STTY, 5-45 
STTY COMMAND, D=-03 


SYS 
SYS, 3-45 
SYS DECISION TASLE FOR CALCULATING TCB SIZE, BASED ON CPU 
MODEL AND SIP/CIP CHARACTERISTICS (TSL), 5-49 


SYSTEM BUILDING 
INTERACTIVE SYSTEM BUILDING PROGRAM, 4-0! 
SYSTEM BUILDING, 1-02 
SYSTEM BUILDING OVERVIEW, 1-01 
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